@stackoverflow/stacks 1.3.0 → 1.3.3

package/lib/css/components/labels.less

@@ -0,0 +1,98 @@
+.s-label {
+    --_fs: var(--fs-body2);
+
+    &[for] {
+        cursor: pointer;
+    }
+
+    fieldset[disabled] &,
+    .is-disabled & {
+        cursor: not-allowed;
+        opacity: var(--_o-disabled-static);
+
+        .s-description {
+            opacity: unset;
+        }
+    }
+
+    .is-readonly & {
+        cursor: not-allowed;
+    }
+
+    .s-description,
+    .s-input-message {
+        font-weight: normal;
+        margin-bottom: 0;
+        margin-top: var(--su4);
+        padding: 0;
+    }
+
+    // Sizes
+    &.s-label__sm {
+        --_fs: var(--fs-caption);
+    }
+    &.s-label__md {
+        --_fs: var(--fs-body3);
+    }
+    &.s-label__lg {
+        --_fs: var(--fs-title);
+    }
+    &.s-label__xl {
+        --_fs: var(--fs-headline1);
+    }
+
+    color: var(--fc-dark);
+    font-family: inherit;
+    font-size: var(--_fs);
+    font-weight: 600;
+    padding: 0 var(--su2); // Helps the label visually line up with inputs
+}
+
+//  $$  LABEL STATUS FLAG
+//  ----------------------------------------------------------------------------
+//      Is this form item required or optional? Flag the status for users.
+//      Default styling is optional.
+.s-label--status {
+    --_b: none;
+    --_bg: var(--black-050);
+    --_fc: var(--fc-medium);
+
+    .highcontrast-mode({
+        --_b: var(--su-static1) solid currentColor;
+    });
+
+    &.s-label--status__required {
+        --_bg: var(--red-100);
+        --_fc: var(--red-700);
+
+        .dark-mode({
+            --_bg: var(--red-050);
+            --_fc: var(--red-800);
+        });
+    }
+
+    &.s-label--status__new {
+        --_bg: var(--green-100);
+        --_fc: var(--green-700);
+
+        .dark-mode({
+            --_bg: var(--green-050);
+            --_fc: var(--green-800);
+        });
+    }
+
+    &.s-label--status__beta {
+        --_bg: var(--blue-100);
+        --_fc: var(--blue-700);
+    }
+
+    background-color: var(--_bg);
+    border: var(--_b);
+    border-radius: 1000px;
+    color: var(--_fc);
+    font-size: var(--fs-caption);
+    font-weight: 400;
+    margin-left: var(--su4);
+    padding: var(--su2) var(--su8);
+    vertical-align: text-bottom;
+}

package/lib/css/components/links.less

@@ -190,6 +190,8 @@ button.s-link {
     @focus-styles();
 
     &.is-selected {
+        --_block-bs: inset var(--_block-bs-offset-x, 3px) 0 0 var(--theme-primary-color);
+
         color: var(--black-800);
         font-weight: bold;
         background-color: var(--black-050);
@@ -199,11 +201,21 @@ button.s-link {
         });
 
         &.s-block-link__right {
-            box-shadow: inset -3px 0 0 var(--theme-primary-color);
+            --_block-bs-offset-x: -3px;
         }
 
-        &.s-block-link__left {
-            box-shadow: inset 3px 0 0 var(--theme-primary-color);
+        &.s-block-link__left,
+        &.s-block-link__right {
+            box-shadow: var(--_block-bs);
+
+            &:focus:not(:focus-visible),
+            &:focus-visible {
+                outline: none;
+            }
+
+            &:focus-visible {
+                box-shadow: var(--_block-bs), 0 0 0 var(--su-static4) var(--focus-ring-muted);
+            }
         }
     }
 

package/lib/css/components/notices.less

@@ -6,206 +6,224 @@
 //  Stack Overflow. For documentation of all these classes and how to contribute,
 //  visit https://stackoverflow.design/
 //
-//  TABLE OF CONTENTS
-//  • BASE STYLE
-//  • LAYOUT TRANSITIONS
-//
-//  ============================================================================
-//  $   BASE STYLES
-//  ----------------------------------------------------------------------------
-//  $$  FILLED, MUTED
-.s-notice {
-    padding: var(--su16);
-    border: 1px solid transparent;
-    border-radius: var(--br-sm);
-    color: var(--fc-medium);
+.construct-notice-component() {
+    background: var(--_bg, var(--black-050));
+    border-color: var(--_bc, var(--bc-medium));
+    border-style: solid;
+    color: var(--_fc, var(--fc-medium));
     font-size: var(--fs-body1);
 
-    .s-toast & {
-        max-width: 44rem;
-        width: 100%;
-        padding-top: var(--su8);
-        padding-bottom: var(--su8);
-        box-shadow: var(--bs-sm);
-        pointer-events: all;
+    code {
+        background: var(--_code-bg, transparent);
     }
 
-    .s-notice--btn {
-        color: var(--fc-dark);
+    & &--btn {
+        color: inherit;
         padding: var(--su8);
-    }
-}
-
-//  ============================================================================
-//  $   VISUAL STYLES
-//  ============================================================================
-//  $$  INFO
-//  ----------------------------------------------------------------------------
-.s-notice__info,
-.s-banner__info {
-    border-color: var(--theme-secondary-150);
-    background-color: var(--theme-secondary-050);
 
-    &.s-notice__important,
-    &.s-banner__important {
-        background-color: var(--theme-secondary-400);
-    }
-
-    // Improve the presentation of buttons
-    .s-notice--btn {
         &:focus,
         &:hover {
-            background-color: var(--theme-secondary-300);
+            background: var(--_btn-focus-bg, var(--black-100));
         }
 
         &:active {
-            background-color: var(--theme-secondary-400);
+            background: var(--_btn-active-bg, var(--black-150));
         }
     }
 
-    code {
-        background-color: var(--theme-secondary-150);
+    &:not(&__important) {
+        .dark-mode({ --_bc: var(--_bg); });
+        .highcontrast-mode({ --_bc: currentColor; });
+        .highcontrast-dark-mode({ --_bc: currentColor; });
     }
-}
 
-//  $$  SUCCESS
-//  ----------------------------------------------------------------------------
-.s-notice__success,
-.s-banner__success {
-    border-color: var(--green-200);
-    background-color: var(--green-050);
-
-    // Bump up the border contrast in high contrast mode
-    .highcontrast-mode({
-        background-color: var(--green-200);
-        border-color: var(--green-400);
-    });
-
-    &.s-notice__important,
-    &.s-banner__important {
-        background-color: var(--green-400);
-        color: var(--black-900);
-
-        // Bump up the text in high contrast
+    &__important {
+        --_bc: var(--_bg);
+        --_bg: var(--black-700);
+        --_fc: var(--white);
+        --_btn-focus-bg: var(--black-800);
+        --_btn-active-bg: var(--black-900);
+
+        .highcontrast-mode({ --_bc: var(--_bg); });
+    }
+
+    &__danger {
+        --_bc: var(--red-200);
+        --_bg: var(--red-050);
+        --_btn-focus-bg: var(--red-100);
+        --_btn-active-bg: var(--red-200);
+    }
+    &__danger:not(&__important) {
         .highcontrast-mode({
-            background-color: var(--green-500);
-            color: var(--white);
-            border-color: transparent;
+            --_bg: var(--red-200);
         });
     }
-
-    // Improve the presentation of buttons
-    .s-notice--btn {
-        &:focus,
-        &:hover {
-            background-color: var(--green-100);
-        }
-
-        &:active {
-            background-color: var(--green-200);
-        }
+    &__danger&__important {
+        --_bc: var(--_bg);
+        --_bg: var(--red-500);
+        --_btn-focus-bg: var(--red-600);
+        --_btn-active-bg: var(--red-700);
+
+        .dark-mode({
+            --_bg: var(--red-400);
+            --_fc: var(--black-900);
+        });
+        .highcontrast-dark-mode({
+            --_bg: var(--red-500);
+            --_fc: var(--white);
+        });
     }
-}
 
-//  $$  WARNING
-//  ----------------------------------------------------------------------------
-.s-notice__warning,
-.s-banner__warning {
-    border-color: var(--yellow-300);
-    background-color: var(--yellow-050);
-
-    // Bump up the border contrast in high contrast mode
-    .highcontrast-mode({
-        background-color: var(--yellow-200);
-        border-color: var(--yellow-700);
-    });
-
-    &.s-notice__important,
-    &.s-banner__important {
-        background-color: var(--yellow-400);
-        color: var(--black-900);
-
-        // Bump up the text in high contrast
+    &__info {
+        --_bc: var(--theme-secondary-150);
+        --_bg: var(--theme-secondary-050);
+        --_btn-focus-bg: var(--theme-secondary-100);
+        --_btn-active-bg: var(--theme-secondary-150);
+        --_code-bg: var(--theme-secondary-150);
+    }
+    &__info:not(&__important) {
         .highcontrast-mode({
-            background-color: var(--yellow-500);
-            color: var(--white);
-            border-color: transparent;
+            --_bg: var(--theme-secondary-100);
+        });
+        .highcontrast-dark-mode({
+            --_bg: var(--theme-secondary-100);
+        });
+    }
+    &__info&__important {
+        --_bc: var(--_bg);
+        --_bg: var(--theme-secondary-400);
+        --_btn-focus-bg: var(--theme-secondary-500);
+        --_btn-active-bg: var(--theme-secondary-600);
+
+        .dark-mode({
+            --_bg: var(--theme-secondary-300);
+            --_fc: var(--black-900);
+        });
+        .highcontrast-dark-mode({
+            --_bg: var(--theme-secondary-400);
+            --_fc: var(--white);
         });
     }
 
-    // Improve the presentation of buttons
-    .s-notice--btn {
-        &:focus,
-        &:hover {
-            background-color: var(--yellow-200);
-        }
-
-        &:active {
-            background-color: var(--yellow-300);
-        }
+    &__success {
+        --_bc: var(--green-200);
+        --_bg: var(--green-050);
+        --_btn-focus-bg: var(--green-100);
+        --_btn-active-bg: var(--green-200);
+    }
+    &__success:not(&__important) {
+        .highcontrast-mode({
+            --_bg: var(--green-200);
+        });
+    }
+    &__success&__important {
+        --_bc: var(--_bg);
+        --_bg: var(--green-400);
+        --_fc: var(--black-900);
+        --_btn-focus-bg: var(--green-500);
+        --_btn-active-bg: var(--green-600);
+
+        .dark-mode({
+            --_bg: var(--green-500);
+            --_fc: var(--white);
+        });
+        .highcontrast-mode({
+            --_bg: var(--green-500);
+            --_fc: var(--white);
+        });
     }
 
-    code {
-        background-color: var(--yellow-200);
+    &__warning {
+        --_bc: var(--yellow-300);
+        --_bg: var(--yellow-050);
+        --_btn-focus-bg: var(--yellow-200);
+        --_btn-active-bg: var(--yellow-300);
+        --_code-bg: var(--yellow-200);
+    }
+    &__warning:not(&__important) {
+        .highcontrast-mode({
+            --_bg: var(--yellow-200);
+        });
+    }
+    &__warning&__important {
+        --_bc: var(--_bg);
+        --_bg: var(--yellow-400);
+        --_btn-focus-bg: var(--yellow-500);
+        --_btn-active-bg: var(--yellow-600);
+        --_fc: var(--black-900);
+
+        .dark-mode({
+            --_bg: var(--yellow-600);
+            --_fc: var(--white);
+        });
+        .highcontrast-mode({
+            --_bg: var(--yellow-700);
+            --_fc: var(--white);
+        });
     }
 }
 
-//  $$  DANGER
-//  ----------------------------------------------------------------------------
-.s-notice__danger,
-.s-banner__danger {
-    border-color: var(--red-200);
-    background-color: var(--red-050);
-
-    // Bump up the border contrast in high contrast mode
-    .highcontrast-mode({
-        background-color: var(--red-200);
-        border-color: var(--red-500);
-
-        &.s-notice__important,
-        &.s-banner__important {
-            background-color: var(--red-500);
-        }
-    });
-
-    &.s-notice__important,
-    &.s-banner__important {
-        background-color: var(--red-400);
+// Banner
+// TODO deprecate .s-banner (by turning it into a modifier on .s-notice)
+// This would reduce the amount of CSS we ship to the client and simplify our codebase
+.s-banner {
+    .construct-notice-component();
+    --_x-offset: 0;
+    //      When we use .s-banner, we need to adjust the padding-top on
+    //      the body tag. This class correctly adjusts the body padding ONLY if
+    //      the notice is one line. If it wraps to multiple lines, more classes or
+    //      (ideally) JS will need to be used to determine the notice's height
+    //      at the time of render. The padding value is determined like so:
+    //
+    //      50px (top bar) + 44px (notice height) - 1px (bottom border)
+    //
+    //      The borders subtraction are necessary to neatly tuck everything together.
+    //  ----------------------------------------------------------------------------
+    &__body-pt {
+        padding-top: 93px;
     }
-
-    // Improve the presentation of buttons
-    .s-notice--btn {
-        &:focus,
-        &:hover {
-            background-color: var(--red-100);
-        }
-
-        &:active {
-            background-color: var(--red-200);
-        }
+    //  If you want to put the banner above the topbar
+    &.is-pinned {
+        z-index: calc(var(--zi-navigation-fixed) + 1);
+    }
+    // If you want to hide and reveal the banner
+    &[aria-hidden="true"] {
+        --_x-offset: -50px; // TODO convert to su vars
+        visibility: hidden;
+        opacity: 0;
+    }
+    &[aria-hidden="false"] {
+        --_x-offset: 49px; // TODO convert to su vars
+        visibility: visible;
+        opacity: 1;
+    }
+    // When we want to keep hero content capped
+    .s-banner--container {
+        position: relative;
+        width: 100%;
+        max-width: calc(var(--s-step) * 10);
+        margin: 0 auto;
     }
-}
 
-//  $$  IMPORTANT
-//  ----------------------------------------------------------------------------
-.s-notice__important {
-    border-color: transparent;
-    background-color: var(--black-700);
-    color: var(--white);
+    border-width: var(--su-static1) 0;
+    inset: 0 0 auto 0;
+    padding: var(--su12);
+    position: fixed;
+    width: 100%;
+    z-index: calc(var(--zi-navigation-fixed) - 1); // Tuck below topbar
+    -webkit-transform: translate3d(0, var(--_x-offset), 0);
+    transform: translate3d(0, var(--_x-offset), 0);
 }
 
-.s-notice__info,
-.s-notice__success,
-.s-notice__warning,
-.s-notice__danger {
-    .dark-mode({ border-color: transparent; });
-    .highcontrast-mode({ border-color: currentColor; });
-
+// Notice
+.s-notice {
+    .construct-notice-component();
+    border-radius: var(--br-sm);
+    border-width: var(--su-static1);
+    padding: var(--su16);
 }
 
-//  ============================================================================
-//  $   TOASTS
-//  ----------------------------------------------------------------------------
+// Toast
 .s-toast {
     visibility: hidden;
     position: fixed;
@@ -230,4 +248,13 @@
     @media (prefers-reduced-motion) {
         transform: none;
     }
+
+    .s-notice {
+        max-width: 44rem;
+        width: 100%;
+        padding-top: var(--su8);
+        padding-bottom: var(--su8);
+        box-shadow: var(--bs-sm);
+        pointer-events: all;
+    }
 }