@stackoverflow/stacks 1.5.0 → 1.6.0

package/lib/css/components/progress-bars.less

@@ -1,330 +1,269 @@
-//
-//  STACK OVERFLOW
-//  PROGRESS BARS
-//
-//  This CSS comes from Stacks, our CSS & Pattern library for rapidly building
-//  Stack Overflow. For documentation of all these classes and how to contribute,
-//  visit https://stackoverflow.design/
-//
-//  TABLE OF CONTENTS
-//  • BASE STYLE
-//  • VARIATION PROGRESS BACKGROUNDS
-//  • BADGES
-//  • STEPPED
-
-//  ============================================================================
-//  $   BASE STYLE
-//  ----------------------------------------------------------------------------
-.s-progress,
-.s-progress--bar {
-    position: relative;
-    min-height: var(--su-static4);
-    min-width: var(--su-static6);
-    border-radius: var(--br-sm);
-}
-
-//  $$   PROGRESS WRAPPER
-//  ----------------------------------------------------------------------------
 .s-progress {
-    width: 100%;
-    background-color: var(--black-200);
-}
-
-//  $$   BAR
-//  ----------------------------------------------------------------------------
-.s-progress--bar {
-    height: 100%;
-    background-color: var(--green-400);
-}
-
-//  $$   LABEL
-//       For when there's descriptive, label copy within the progress bar
-//  ----------------------------------------------------------------------------
-.s-progress--label {
-    position: absolute;
-    width: 100%;
-    height: 100%;
-    border-radius: var(--br-md);
-    border: 1px solid transparent;
-    font-size: var(--fs-caption);
-    line-height: var(--lh-xs);
-    color: var(--fc-dark);
-    z-index: calc(var(--zi-base) + 2);
-}
-
-//  ===========================================================================
-//  $   VARIATION PROGRESS BACKGROUNDS
-//  ---------------------------------------------------------------------------
-.s-progress__brand .s-progress--bar {
-    background-color: var(--orange-500);
-}
-
-.s-progress__info .s-progress--bar {
-    background-color: var(--blue-500);
-}
-
-.s-progress__privilege {
-    .s-progress--bar {
-        background-color: var(--green-050);
-
-        .highcontrast-mode({
-            background-color: var(--green-200);
-        });
+    // BASE COMPONENT-SPECIFIC CUSTOM PROPERTIES
+    --_pr-bar: var(--br-sm);
+    --_pr-bg: var(--black-200);
+    --_pr-h: unset;
+    --_pr-size: unset;
+    --_pr-w: 100%;
+    --_pr-hmn: var(--su-static4);
+    --_pr-bar-bar: var(--br-sm);
+    --_pr-bar-bg: var(--green-400);
+    --_pr-bar-hmn: var(--su-static4);
+    --_pr-label-ai: unset;
+    --_pr-label-bc: transparent;
+    --_pr-label-d: unset;
+    --_pr-label-g: unset;
+    --_pr-label-jc: unset;
+    --_pr-label-px: unset;
+
+    // MODIFIERS
+    &&__brand {
+        --_pr-bar-bg: var(--orange-500);
     }
-    .s-progress--label {
-        border-color: var(--green-400);
-        display: flex;
-        gap: var(--su4);
-        align-items: center;
-        justify-content: center;
+    &&__bronze {
+        --_pr-bar-bg: var(--bronze-lighter);
+        --_pr-label-bc: var(--bronze-darker);
+    }
+    &&__gold {
+        --_pr-bar-bg: var(--gold-lighter);
+        --_pr-label-bc: var(--gold-darker);
+    }
+    &&__info {
+        --_pr-bar-bg: var(--blue-500);
+    }
+    &&__silver {
+        --_pr-bar-bg: var(--silver-lighter);
+        --_pr-label-bc: var(--silver-darker);
     }
-}
-
-//  ===========================================================================
-//  $   BADGE PROGRESS BARS
-//  ===========================================================================
-.s-progress__privilege,
-.s-progress__privilege .s-progress--bar,
-.s-progress__badge,
-.s-progress__badge .s-progress--bar {
-    min-height: 2em;
-    border-radius: var(--br-md);
-}
-
-.s-progress__privilege,
-.s-progress__badge {
-    background-color: transparent;
-}
 
-.s-progress__badge {
-    .s-progress--label {
-        display: flex;
-        gap: var(--su4);
-        align-items: center;
-        padding-left: 1em;
-        padding-right: 1em;
+    // VARIANTS
+    &&__badge,
+    &&__privilege {
+        --_pr-bar: var(--br-md);
+        --_pr-bg: transparent;
+        --_pr-hmn: 2em;
+        --_pr-bar-bar: var(--br-md);
+        --_pr-bar-hmn: 2em;
+        --_pr-label-d: flex;
+        --_pr-label-g: var(--su4);
+    }
+    &&__badge {
+        --_pr-label-ai: center;
+        --_pr-label-px: 1em;
 
-        .s-badge--label {
-            text-align: center;
-            flex-grow: 1;
+        .s-progress--label {
+            .s-badge--label {
+                flex-grow: 1;
+                text-align: center;
+            }
         }
     }
-}
+    &&__circular {
+        --_pr-bg: transparent;
+        --_pr-size: var(--su-static32);
+        --s-progress-value: 0;
+        @s-progress-circle-circumference: (2 * pi() * 14); // 2πr, r = 14.
+
+        &.s-progress {
+            &__sm {
+                --_pr-size: var(--su-static24);
+            }
+            &__md {
+                --_pr-size: var(--su-static48);
+            }
+            &__lg {
+                --_pr-size: var(--su-static64);
+            }
+        }
+        // TODO: consider renaming to `.s-progress--bar`
+        .s-progress-bar { // It may necessitate wrapping element in a `&:not(&__circular)`
+            circle {
+                &:nth-of-type(1) {
+                    opacity: 0.4;
+                    stroke: currentColor;
+                }
+                &:nth-of-type(2) {
+                    stroke: currentColor;
+                    stroke-dasharray: @s-progress-circle-circumference; // [1]
+                    stroke-dashoffset: calc(((1 - var(--s-progress-value)) * @s-progress-circle-circumference) * 1px); // Multiply everything by 1px since Safari and Firefox require these to be in pixels
+                }
+
+                fill: none;
+                stroke-linecap: round;
+                stroke-width: var(--su-static4);
+            }
 
-//  $$  GOLD
-//  ---------------------------------------------------------------------------
-.s-progress__gold {
-    .s-progress--bar {
-        background-color: var(--gold-lighter);
-    }
-    .s-progress--label {
-        border-color: var(--gold-darker);
+            transform: rotate(270deg); // Make everything originate from the top of the circle
+        }
     }
-}
+    &&__privilege {
+        --_pr-bar-bg: var(--green-050);
+        --_pr-label-ai: center;
+        --_pr-label-bc: var(--green-400);
+        --_pr-label-jc: center;
 
-//  $$  SILVER
-//  ---------------------------------------------------------------------------
-.s-progress__silver {
-    .s-progress--bar {
-        background-color: var(--silver-lighter);
-    }
-    .s-progress--label {
-        border-color: var(--silver-darker);
+        .highcontrast-mode({ --_pr-bar-bg: var(--green-200); });
     }
-}
+    // TODO move `.s-progress__stepped` to entirely separate component (or consider deprecating)
+    &&__stepped { // There's so little overlap with the base .s-progress that it doesn't make sense as a variant
+        background: transparent;
+        display: flex;
 
-//  $$  BRONZE
-//  ---------------------------------------------------------------------------
-.s-progress__bronze {
-    .s-progress--bar {
-        background-color: var(--bronze-lighter);
-    }
-    .s-progress--label {
-        border-color: var(--bronze-darker);
+        .s-progress {
+            &--bar {
+                &.s-progress--bar {
+                    &__left {
+                        left: 0;
+                        right: 50%;
+                    }
+                    &__right {
+                        left: 50%;
+                        right: 0;
+                    }
+                }
+
+                background: var(--black-300);
+                border-radius: 0;
+                height: var(--su-static6);
+                position: absolute;
+                top: calc(var(--su-static8) + var(--su-static1));
+                z-index: var(--zi-base);
+            }
+            &--label { // Override a ton of properties
+                border: 0;
+                border-radius: 0;
+                color: var(--black-500);
+                display: block;
+                font-size: var(--fs-body1);
+                height: auto;
+                padding: var(--su12) var(--su6) 0 var(--su6);
+                position: static;
+                text-align: center;
+                width: auto;
+                z-index: var(--zi-base);
+            }
+            &--step {
+                &.is-active {
+                    .s-progress {
+                        &--bar.s-progress--bar__left {
+                            background: var(--theme-secondary-400);
+                        }
+                        &--label {
+                            color: var(--fc-dark);
+                        }
+                        &--stop {
+                            background: var(--theme-secondary-400);
+                            box-shadow: 0 0 0 var(--su-static6) var(--focus-ring);
+                        }
+                    }
+                }
+                &.is-complete {
+                    .s-progress {
+                        &--bar,
+                        &--stop {
+                            background: var(--theme-secondary-400);
+                        }
+                        &--label {
+                            color: var(--fc-dark);
+                        }
+                    }
+                }
+
+                align-items: center;
+                display: flex;
+                flex-basis: 0;
+                flex-direction: column;
+                flex-grow: 1;
+                flex-shrink: 1;
+                position: relative;
+            }
+            &--stop {
+                .highcontrast-mode({
+                    color: var(--white);
+                });
+
+                align-items: center;
+                background: var(--black-300);
+                border-radius: 100%;
+                color: @white;
+                display: flex;
+                height: var(--su-static24);
+                justify-content: center;
+                position: relative;
+                width: var(--su-static24);
+                z-index: var(--zi-selected);
+            }
+        }
     }
-}
 
-//  ===========================================================================
-//  $   SEGMENTED
-//  ---------------------------------------------------------------------------
-.s-progress.s-progress__segmented {
-    position: relative;
+    // CHILD ELEMENTS
+    & &--bar {
+        background-color: var(--_pr-bar-bg);
+        border-radius: var(--_pr-bar);
+        min-height: var(--_pr-hmn);
 
-    .s-progress--segments {
-        margin: 0;
-        padding: 0;
+        height: 100%;
+        min-width: var(--su-static6);
+        position: relative;
+    }
+    & &--label {
+        align-items: var(--_pr-label-ai);
+        border: var(--su-static1) solid var(--_pr-label-bc);
+        display: var(--_pr-label-d);
+        gap: var(--_pr-label-g);
+        justify-content: var(--_pr-label-jc);
+        padding-left: var(--_pr-label-px);
+        padding-right: var(--_pr-label-px);
+
+        border-radius: var(--br-md);
+        color: var(--fc-dark);
+        font-size: var(--fs-caption);
+        height: 100%;
+        line-height: var(--lh-xs);
         position: absolute;
-        top: 0;
         width: 100%;
-        height: 100%;
-        display: flex;
-        justify-content: space-between;
-        list-style: none;
-
+        z-index: calc(var(--zi-base) + 2);
+    }
+    & &--segments { // DEPRECATED: AFAICT, this is unused in core (as well as it's intended parent variant class `.s-progress__segmented`)
         li {
-            display: block;
-            padding-top: 4px;
-            position: relative;
-            text-align: center;
-
             &:not(:first-child):not(:last-child):before {
-                display: block;
+                background-color: var(--white);
                 content: "";
+                display: block;
                 height: 100%;
-                width: 4px;
+                left: calc(var(--su-static) * -1); // -1px
                 position: absolute;
                 top: 0;
-                left: -1px;
-                background-color: var(--white);
+                width: var(--su-static4);
             }
-        }
-    }
-}
-
-//  ===========================================================================
-//  $   STEPPED
-//  ---------------------------------------------------------------------------
-.s-progress.s-progress__stepped {
-    background: transparent;
-    display: flex;
-
-    .s-progress--step {
-        display: flex;
-        flex-grow: 1;
-        flex-shrink: 1;
-        flex-basis: 0;
-        flex-direction: column;
-        align-items: center;
-        position: relative;
-    }
 
-    .s-progress--label {
-        // Override a ton of properties
-        position: static;
-        display: block;
-        width: auto;
-        height: auto;
-        font-size: var(--fs-body1);
-        border: 0;
-        border-radius: 0;
-        padding: var(--su12) var(--su6) 0 var(--su6);
-        text-align: center;
-        color: var(--black-500);
-        z-index: var(--zi-base);
-    }
+            display: block;
+            padding-top: var(--su-static4);
+            position: relative;
+            text-align: center;
+        }
 
-    .s-progress--stop {
-        position: relative;
         display: flex;
-        align-items: center;
-        justify-content: center;
-        background: var(--black-300);
-        border-radius: 100%;
-        width: var(--su-static24);
-        height: var(--su-static24);
-        z-index: var(--zi-selected);
-        color: @white;
-
-        .highcontrast-mode({
-            color: var(--white);
-        });
-    }
-
-    .s-progress--bar {
+        height: 100%;
+        justify-content: space-between;
+        list-style: none;
+        margin: 0;
+        padding: 0;
         position: absolute;
-        top: calc(var(--su-static8) + var(--su-static1));
-        height: var(--su-static6);
-        background: var(--black-300);
-        z-index: var(--zi-base);
-        border-radius: 0;
-
-        &.s-progress--bar__left {
-            left: 0;
-            right: 50%;
-        }
-
-        &.s-progress--bar__right {
-            right: 0;
-            left: 50%;
-        }
-    }
-
-    .s-progress--step.is-active {
-        .s-progress--bar.s-progress--bar__left {
-            background: var(--theme-secondary-400);
-        }
-
-        .s-progress--stop {
-            background: var(--theme-secondary-400);
-            box-shadow: 0 0 0 var(--su-static6) var(--focus-ring);
-        }
-
-        .s-progress--label {
-            color: var(--fc-dark);
-        }
+        top: 0;
+        width: 100%;
     }
 
-    .s-progress--step.is-complete {
-        .s-progress--bar,
-        .s-progress--stop {
-            background: var(--theme-secondary-400);
-        }
+    background-color: var(--_pr-bg);
+    border-radius: var(--_pr-bar);
+    height: var(--_pr-size, var(--_pr-h));
+    min-height: var(--_pr-hmn);
 
-        .s-progress--label {
-            color: var(--fc-dark);
-        }
-    }
+    min-width: var(--su-static6);
+    position: relative;
+    width: var(--_pr-size, var(--_pr-w));
 }
 
-//  ===========================================================================
-//  $   CIRCULAR
-//  ---------------------------------------------------------------------------
-.s-progress__circular {
-    --s-progress-value: 0;
-    @s-progress-circle-circumference: (2 * pi() * 14); // 2πr, r = 14.
-
-    background: none;
-    width: var(--su-static32);
-    height: var(--su-static32);
-
-    .s-progress-bar {
-        // Make everything originate from the top of the circle
-        transform: rotate(270deg);
-
-        circle {
-            stroke-width: var(--su-static4);
-            fill: none;
-            stroke-linecap: round;
-        }
-
-        circle:nth-of-type(1) {
-            stroke: currentColor;
-            opacity: 0.4;
-        }
-
-        circle:nth-of-type(2) {
-            stroke: currentColor;
-            stroke-dasharray: @s-progress-circle-circumference;
-
-            // Multiply the circle circumference by an the opposite percentage of what we want to display
-            // For example 70%, represented as a decimal is 0.7
-            // The opposite of that is 0.3 so ( 1 - 0.7 )
-            stroke-dashoffset: calc(((1 - var(--s-progress-value)) * @s-progress-circle-circumference) * 1px); // Multiply everything by 1px since Safari and Firefox require these to be in pixels
-        }
-    }
-
-    &.s-progress__sm {
-        width: var(--su-static24);
-        height: var(--su-static24);
-    }
-
-    &.s-progress__md {
-        width: var(--su-static48);
-        height: var(--su-static48);
-    }
-
-    &.s-progress__lg {
-        width: var(--su-static64);
-        height: var(--su-static64);
-    }
-}
+// [1] Multiply the circle circumference by an the opposite percentage of what we want to display
+//      For example 70%, represented as a decimal is 0.7
+//      The opposite of that is 0.3 so ( 1 - 0.7 )