@sc-360-v2/storefront-cms-library 0.5.73 → 0.5.74

package/dist/option-families.scss

@@ -0,0 +1,252 @@
+@use "./functions.scss" as *;
+
+// Option Families — swatch tiles of option families ("Shop by Color"): every family, the ones
+// picked in Choose Item, or one per row when repeated by a Repeater.
+//
+// Variable names come from the builderData keys in element-edit/optionFamilies.ts:
+//   layout.swatchHeight -> --_ctm-lt-sh-ht
+//   design.tile.*       -> --_ctm-dn-te-*
+//   design.swatch.*     -> --_ctm-dn-sh-*
+//   design.image.*      -> --_ctm-dn-ie-*
+//   design.label.*      -> --_ctm-dn-ll-*
+// Keep this file in step with storefront-cms-library/src/components/css/widgets/option-families.scss.
+
+[data-div-type="element"] {
+  &[data-element-type="optionFamilies"] {
+    // Reads the percentage the left/right resize handles write, same as Quota Details.
+    width: var(
+      --_sf-el-wh-st-mx,
+      calc(
+        1% * var(--_ctm-mob-ele-nw-wh-vl, var(--_ctm-tab-ele-nw-wh-vl, var(--_ctm-ele-nw-wh-vl)))
+      )
+    );
+    min-width: 64px;
+    margin: prepareMediaVariable(--_ctm-lt-mn, 0);
+
+    & > .wrapper {
+      width: 100%;
+      height: auto;
+    }
+
+    // Connected on its own the element holds every family shown in Choose Item, one tile each,
+    // side by side in a single row that shares the element's width. Inside a Repeater it holds one.
+    .option__families__list {
+      display: flex;
+      flex-wrap: nowrap;
+      gap: 12px;
+      width: 100%;
+
+      & > * {
+        flex: 1 1 0;
+        min-width: 0;
+      }
+    }
+
+    .option__families__tile {
+      display: flex;
+      flex-direction: column;
+      gap: prepareMediaVariable(--_ctm-dn-te-im-gp);
+      width: 100%;
+      box-sizing: border-box;
+      padding: prepareMediaVariable(--_ctm-lt-pg, 8px);
+      color: inherit;
+      text-decoration: none;
+      background-color: prepareMediaVariable(--_ctm-dn-te-bd-cr, #ffffff);
+      border-color: prepareMediaVariable(--_ctm-dn-te-br-cr, #eaecf0);
+      border-style: prepareMediaVariable(--_ctm-dn-te-br-se, solid);
+      border-width: prepareMediaVariable(--_ctm-dn-te-br-wh, 1px);
+      border-radius: prepareMediaVariable(--_ctm-dn-te-br-rs, 6px);
+      box-shadow: var(
+        --_sf-of-te-show-shadow,
+        prepareMediaVariable(--_ctm-dn-te-sw-ae, 0px 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-br, 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-sd, 0px)
+          prepareMediaVariable(--_ctm-dn-te-sw-cr, transparent)
+      );
+      transition: transform 0.15s ease;
+
+      &[data-has-link="true"] {
+        cursor: pointer;
+
+        // &:hover {
+        //   transform: translateY(-2px);
+        // }
+      }
+    }
+
+    &[data-tile-shadow="false"] .option__families__tile {
+      --_sf-of-te-show-shadow: none;
+    }
+
+    .option__families__swatch {
+      position: relative;
+      display: flex;
+      align-items: flex-end;
+      justify-content: center;
+      overflow: hidden;
+      width: 100%;
+      height: prepareMediaVariable(--_ctm-lt-sh-ht, 88px);
+      box-sizing: border-box;
+      // `--_sf-of-swatch` is the row's hex colour, set on the element by the renderer.
+      background-color: var(--_sf-of-swatch, #d0d5dd);
+      border-color: prepareMediaVariable(--_ctm-dn-sh-br-cr, #eaecf0);
+      border-style: prepareMediaVariable(--_ctm-dn-sh-br-se, solid);
+      border-width: prepareMediaVariable(--_ctm-dn-sh-br-wh, 0px);
+      border-radius: prepareMediaVariable(--_ctm-dn-sh-br-rs, 4px);
+      box-shadow: var(
+        --_sf-of-sh-show-shadow,
+        prepareMediaVariable(--_ctm-dn-sh-sw-ae, 0px 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-br, 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-sd, 0px)
+          prepareMediaVariable(--_ctm-dn-sh-sw-cr, transparent)
+      );
+
+      // Measured by SwatchImage (OptionFamilies.tsx) for the size it asks the CDN for.
+      .option__families__image-frame {
+        position: absolute;
+        inset: 0;
+      }
+
+      .option__families__image {
+        position: absolute;
+        inset: 0;
+        width: 100%;
+        height: 100%;
+        box-sizing: border-box;
+        object-fit: cover;
+        object-position: center;
+        background-color: prepareMediaVariable(--_ctm-dn-ie-bd-cr, transparent);
+        border-color: prepareMediaVariable(--_ctm-dn-ie-br-cr, #eaecf0);
+        border-style: prepareMediaVariable(--_ctm-dn-ie-br-se, solid);
+        border-width: prepareMediaVariable(--_ctm-dn-ie-br-wh, 0px);
+        border-radius: prepareMediaVariable(--_ctm-dn-ie-br-rs, 0px);
+        transition: transform 0.3s ease-in-out;
+        // Fit Options and Image Position are applied by the image CDN (scale.option /
+        // canvas.position in the request URL, see OptionFamilies.tsx), which returns an
+        // image of exactly the swatch's size — so nothing to fit here.
+      }
+
+      .option__families__label {
+        position: relative;
+        z-index: 2;
+        padding: 0 6px 8px;
+      }
+    }
+
+    // Layout > Image Settings > On Hover. The swatch clips it (overflow: hidden), so the
+    // zoom stays inside the tile. Zoom Out is a visible 0.92 — the Image element's 0.9998
+    // is too small to see on a swatch this size.
+    .option__families__tile:hover .option__families__image {
+      &[data-on-hover="Zoom In"] {
+        transform: scale(1.08);
+      }
+      &[data-on-hover="Zoom Out"] {
+        transform: scale(0.92);
+      }
+    }
+
+    // Layout > Swatch Shape. Rectangle is the default above: a full-width tile and swatch, with
+    // the Border Radius set in Design for each. Square and Circle make the swatch Swatch Height on
+    // each side and shrink the tile around it, so every border — tile, swatch and image — takes
+    // the shape: square corners for Square, round for Circle. There the shape decides the corners
+    // and the Design > Border Radius controls do not apply.
+    &[data-swatch-shape="square"],
+    &[data-swatch-shape="circle"] {
+      .option__families__tile {
+        flex: 0 1 auto;
+        width: fit-content;
+        max-width: 100%;
+        margin-inline: auto;
+      }
+
+      .option__families__swatch {
+        width: prepareMediaVariable(--_ctm-lt-sh-ht, 88px);
+        max-width: 100%;
+        align-self: center;
+      }
+    }
+
+    // &[data-swatch-shape="square"] {
+    //   .option__families__tile,
+    //   .option__families__swatch,
+    //   .option__families__image {
+    //     border-radius: 0;
+    //   }
+    // }
+
+    &[data-swatch-shape="circle"] {
+      // The swatch and its image are square boxes, so 50% makes them round.
+      .option__families__swatch,
+      .option__families__image {
+        border-radius: 50%;
+      }
+
+      // With the name inside the swatch the tile is square too (swatch plus even padding) and
+      // 50% draws a circle. A name below makes it taller than wide, where 50% would draw an
+      // oval, so it becomes a pill instead.
+      &[data-label-position="inside"] .option__families__tile {
+        border-radius: 50%;
+      }
+      &[data-label-position="below"] .option__families__tile {
+        border-radius: 9999px;
+      }
+    }
+
+    &[data-swatch-shadow="false"] .option__families__swatch {
+      --_sf-of-sh-show-shadow: none;
+    }
+
+    .option__families__label {
+      display: block;
+      min-width: 0;
+      overflow-wrap: anywhere;
+      color: prepareMediaVariable(--_ctm-dn-ll-cr, #ffffff);
+      font-family: prepareMediaVariable(--_ctm-dn-ll-ft-fy);
+      font-size: prepareMediaVariable(--_ctm-dn-ll-ft-se, 14px);
+      font-weight: prepareMediaVariable(--_ctm-dn-ll-ft-wt, bold);
+      font-style: prepareMediaVariable(--_ctm-dn-ll-ft-se-ic);
+      text-align: prepareMediaVariable(--_ctm-dn-ll-tt-an, center);
+      letter-spacing: prepareMediaVariable(--_ctm-dn-ll-lr-sg);
+      line-height: prepareMediaVariable(--_ctm-dn-ll-le-ht);
+      text-decoration: prepareMediaVariable(--_ctm-dn-ll-ue);
+      text-transform: prepareMediaVariable(--_ctm-dn-ll-tt-tm, uppercase);
+      box-sizing: border-box;
+      max-width: 100%;
+
+      // Design > Label > Typography > Text Overflow: N lines, then an ellipsis. `--_sf-line-clamp`
+      // is set on the label by the renderer. `overflow-wrap: anywhere` above would break a long
+      // word across lines before the ellipsis could apply, so the clamp restores normal wrapping.
+      &.flex__overflow {
+        @include restrictToLinesShow(#{var(--_sf-line-clamp, 1)});
+        overflow-wrap: normal;
+        word-break: normal;
+      }
+    }
+
+    // A Square or Circle tile is only as wide as its content. A label below the swatch would
+    // widen it to fit the whole name, leaving nothing to clamp; this makes the label take the
+    // tile's width (set by the swatch) without adding to it.
+    &[data-swatch-shape="square"],
+    &[data-swatch-shape="circle"] {
+      &[data-label-position="below"] .option__families__tile > .option__families__label {
+        width: 0;
+        min-width: 100%;
+      }
+    }
+
+    // Light swatches get a faint inner edge so they don't melt into a white tile. An
+    // outline, not the border: the border width holds four values and is the merchant's.
+    .option__families__swatch[data-light="true"] {
+      outline: 1px solid rgba(16, 24, 40, 0.12);
+      outline-offset: -1px;
+    }
+
+    // A white label disappears on white/cream swatches. Only while the label sits inside
+    // the swatch — below it, the label is on the tile and keeps its own colour.
+    &[data-label-position="inside"]
+      .option__families__swatch[data-light="true"]
+      .option__families__label {
+      color: #344054;
+    }
+  }
+}