material-inspired-component-library 1.1.1 → 1.2.1

package/README.md

@@ -100,3 +100,7 @@ The library currently consists of the following components:
 ### 1.1.0 (12.08.2025)
 **Features**
 - **Text field**: Added support for multi-line text fields.
+
+### 1.2.0 (17.08.2025)
+**Features**
+- **List**: Added support for switches inside list items.

package/components/list/README.md

@@ -59,6 +59,20 @@ The List component offers three CSS classes to control the height and content ca
 </ul>
 ```
 
+Use the anchor element to convert a list item into a hyperlink:
+
+```HTML
+<ul class="micl-list" role="listbox">
+  <li class="micl-list-item-one" tabindex="0">
+    <a href="https://www.thetimes.com" tabindex="-1">
+      <span class="micl-list-item__text">
+        <span class="micl-list-item__headline">The Times</span>
+      </span>
+    </a>
+  </li>
+</ul>
+```
+
 Adding the `micl-list-item--disabled` class to the `<li>` element causes the list item to be displayed in a disabled state.
 
 Add the `micl-list__divider` class to the `<ul>` element to automatically place a divider between each list item.
@@ -77,10 +91,10 @@ The text content of a list item can be preceded by various media elements:
   </li>
   ```
 
-- **Avatar**: Use `micl-list-item__avatar` with an avatar image (or icon).
+- **Avatar**: Use `micl-list-item__avatar` with a text.
   ```HTML
   <li class="micl-list-item-two" tabindex="0">
-    <span class="material-symbols-outlined micl-list-item__avatar">account_circle</span>
+    <span class="micl-list-item__avatar">BJ</span>
     <span class="micl-list-item__text">
       <span class="micl-list-item__headline">Bill Jones</span>
       <span class="micl-list-item__supporting-text">bill.jones@email.com</span>
@@ -111,35 +125,51 @@ The text content of a list item can be preceded by various media elements:
   ```
 
 ### Trailing Content
-The text of a list item may be followed by a trailing text or other elements (like a checkbox).
+The text of a list item may be followed by a trailing text, imagery or other elements (like a checkbox).
 
-```HTML
-<li class="micl-list-item-one" tabindex="0">
-  <span class="micl-list-item__text">
-    <span class="micl-list-item__headline">To-do items</span>
-  </span>
-  <span class="micl-list-item__trailing-text">100+</span>
-</li>
-````
+- **Icon**: Use `micl-list-item__icon` with a (Material Symbols) icon.
+  ```HTML
+  <li class="micl-list-item-two" tabindex="0">
+    <span class="micl-list-item__text">
+      <span class="micl-list-item__headline">Date and time</span>
+      <span class="micl-list-item__supporting-text">Timezones, calendar display</span>
+    </span>
+    <span class="material-symbols-outlined micl-list-item__icon" aria-hidden="true">more_horiz</span>
+  </li>
+  ```
+
+- **Text**: Use `micl-list-item__trailing-text` with a short text.
+  ```HTML
+  <li class="micl-list-item-one" tabindex="0">
+    <span class="micl-list-item__text">
+      <span class="micl-list-item__headline">To-do items</span>
+    </span>
+    <span class="micl-list-item__trailing-text">100+</span>
+  </li>
+  ````
 
 ### Selecting List Items
-To enable selection of list items, integrate a checkbox component within the `<li>` element. The `micl-list-item__text` should typically wrap the headline and supporting text, acting as the label for the checkbox.
+To enable selection of list items, integrate a checkbox or switch component within the `<li>` element.
 
 ```HTML
 <ul class="micl-list micl-list__divider" role="listbox">
   <li class="micl-list-item-two" tabindex="0">
-    <label for="checkbox1" class="micl-list-item__text">
-      <span class="micl-list-item__headline">Blue car</span>
-      <span class="micl-list-item__supporting-text">A blue car with four wheels.</span>
-    </label>
-    <input type="checkbox" id="checkbox1" class="micl-checkbox" value="cb1" tabindex="-1">
+    <label>
+      <span class="micl-list-item__text">
+        <span class="micl-list-item__headline">Blue car</span>
+        <span class="micl-list-item__supporting-text">A blue car with four wheels.</span>
+      </label>
+      <input type="checkbox" id="mycheckbox" class="micl-checkbox" value="cb1" tabindex="-1">
+    </span>
   </li>
   <li class="micl-list-item-two" tabindex="0">
-    <label for="checkbox2" class="micl-list-item__text">
-      <span class="micl-list-item__headline">Red car</span>
-      <span class="micl-list-item__supporting-text">A red car with tinted windows.</span>
+    <label>
+      <span class="micl-list-item__text">
+        <span class="micl-list-item__headline">Red car</span>
+        <span class="micl-list-item__supporting-text">A red car with tinted windows.</span>
+      </label>
+      <input type="checkbox" id="checkbox2" class="micl-switch" value="cb2" tabindex="-1">
     </label>
-    <input type="checkbox" id="checkbox2" class="micl-checkbox" value="cb2" tabindex="-1">
   </li>
 </ul>
 ```

package/components/list/index.scss

@@ -37,10 +37,10 @@
 }
 
 .micl-list {
-    --md-sys-list-item-background-color: var(--md-sys-color-surface);
+    --md-sys-list-item-container-color: var(--md-sys-color-surface);
 
     margin: 0;
-    padding: 0;
+    padding: 8px 0;
     interpolate-size: allow-keywords;
     list-style-type: none;
 
@@ -68,8 +68,8 @@
                 pointer-events: none;
             }
             &:not(.micl-list-item--disabled) {
-                --miclripple: 1;
                 @include ripple.effect;
+                --miclripple: 1;
 
                 cursor: pointer;
             }
@@ -77,7 +77,7 @@
         .micl-list-item__content {
             box-sizing: border-box;
             padding-inline: var(--md-sys-list-item-padding-inline);
-            background-color: var(--md-sys-list-item-background-color);
+            background-color: var(--md-sys-list-item-container-color);
             overflow: hidden;
         }
     }
@@ -95,16 +95,33 @@
 .micl-list-item-one,
 .micl-list-item-two,
 .micl-list-item-three {
+    --md-sys-list-item-thumbnail-aspect-ratio: 1.778;
+
     box-sizing: border-box;
     display: flex;
     align-items: center;
     column-gap: var(--md-sys-list-item-space);
     padding-inline: var(--md-sys-list-item-space);
     border-radius: var(--md-sys-shape-corner-none);
-    background-color: var(--md-sys-list-item-background-color);
+    background-color: var(--md-sys-list-item-container-color);
     list-style: none;
     transition: background-color var(--md-sys-motion-duration-long2) linear;
 
+    &> a,
+    &> label {
+        display: inherit;
+        align-items: inherit;
+        column-gap: inherit;
+        border-radius: inherit;
+        background-color: inherit;
+        inline-size: 100%;
+        padding-inline: var(--md-sys-list-item-space);
+        text-decoration: none;
+        cursor: pointer;
+    }
+    &:has(> a,> label) {
+        padding-inline: 0;
+    }
     &:disabled,
     &.micl-list-item--disabled {
         .micl-list-item__icon,
@@ -119,12 +136,16 @@
         .micl-list-item__thumbnail {
             opacity: 38%;
         }
+        a, label {
+            pointer-events: none;
+            cursor: auto;
+        }
     }
     &:not(:disabled):not(.micl-list-item--disabled) {
         &:hover {
-            background-color: color-mix(in srgb, var(--md-sys-list-item-background-color), var(--md-sys-color-on-surface) var(--md-sys-state-hover-state-layer-opacity));
+            background-color: color-mix(in srgb, var(--md-sys-list-item-container-color), var(--md-sys-color-on-surface) var(--md-sys-state-hover-state-layer-opacity));
 
-            &:has(input[type=checkbox].micl-checkbox) {
+            &:has(input[type=checkbox]) {
                 cursor: pointer;
             }
             .micl-list-item__icon {
@@ -133,26 +154,26 @@
         }
         &:focus-visible {
             outline: var(--md-sys-state-focus-indicator-thickness) solid var(--md-sys-color-secondary);
-            background-color: color-mix(in srgb, var(--md-sys-list-item-background-color), var(--md-sys-color-on-surface) var(--md-sys-state-focus-state-layer-opacity));
-            z-index: 1;
+            outline-offset: calc(-1 * var(--md-sys-state-focus-indicator-thickness));
+            background-color: color-mix(in srgb, var(--md-sys-list-item-container-color), var(--md-sys-color-on-surface) var(--md-sys-state-focus-state-layer-opacity));
 
             .micl-list-item__icon {
                 font-variation-settings: 'FILL' 1;
             }
         }
         &:active {
-            background-color: color-mix(in srgb, var(--md-sys-list-item-background-color), var(--md-sys-color-on-surface) var(--md-sys-state-pressed-state-layer-opacity));
+            background-color: color-mix(in srgb, var(--md-sys-list-item-container-color), var(--md-sys-color-on-surface) var(--md-sys-state-pressed-state-layer-opacity));
 
             .micl-list-item__icon {
                 font-variation-settings: 'FILL' 1;
             }
         }
-        &:has(input[type=checkbox].micl-checkbox) {
+        &:has(input[type=checkbox]) {
+            @include ripple.effect;
             --miclripple: 1;
             --md-sys-ripple-background-color: var(--md-sys-color-primary);
-            @include ripple.effect;
         }
-        &:has(input[type=checkbox].micl-checkbox:checked) {
+        &:has(input[type=checkbox]:checked) {
             background-color: var(--md-sys-color-secondary-container);
 
             .micl-list-item__headline {
@@ -163,45 +184,70 @@
             .micl-list-item__trailing-text {
                 color: var(--md-sys-color-on-surface);
             }
+            &:focus-visible {
+                background-color: color-mix(in srgb, var(--md-sys-color-secondary-container), var(--md-sys-color-on-surface) var(--md-sys-state-focus-state-layer-opacity));
+            }
+            &:active {
+                background-color: color-mix(in srgb, var(--md-sys-color-secondary-container), var(--md-sys-color-on-surface) var(--md-sys-state-pressed-state-layer-opacity));
+            }
         }
-        input[type=checkbox].micl-checkbox:not(:disabled):hover,
-        input[type=checkbox].micl-checkbox:not(:disabled):active {
+        input[type=checkbox]:not(:disabled):hover,
+        input[type=checkbox]:not(:disabled):active {
             --checkbox-state-layer-color: initial;
             --checkbox-outline-color: initial;
             --md-sys-ripple-background-color: transparent;
         }
     }
-    &> a {
-        box-sizing: border-box;
-        display: flex;
-        align-items: center;
-        align-self: normal;
-        width: 100%;
-        column-gap: var(--md-sys-list-item-space);
-        text-decoration: none;
-    }
 }
 
 .micl-list-item-one {
     min-height: var(--md-sys-list-item-one-height);
-    padding-block-start: var(--md-sys-list-item-one-padding);
-    padding-block-end: var(--md-sys-list-item-one-padding);
 
-    &:has(.micl-list-item__thumbnail) {
-        padding-block-start: var(--md-sys-list-item-three-padding);
-        padding-block-end: var(--md-sys-list-item-three-padding);
-        padding-inline-start: 0px;
+    &:not(:has(> a,> label)) {
+        padding-block-start: var(--md-sys-list-item-one-padding);
+        padding-block-end: var(--md-sys-list-item-one-padding);
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-block-start: var(--md-sys-list-item-three-padding);
+            padding-block-end: var(--md-sys-list-item-three-padding);
+            padding-inline-start: 0px;
+        }
+    }
+    &> a,
+    &> label {
+        padding-block-start: var(--md-sys-list-item-one-padding);
+        padding-block-end: var(--md-sys-list-item-one-padding);
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-block-start: var(--md-sys-list-item-three-padding);
+            padding-block-end: var(--md-sys-list-item-three-padding);
+            padding-inline-start: 0px;
+        }
     }
 }
 .micl-list-item-two {
     min-height: var(--md-sys-list-item-two-height);
-    padding-block-start: var(--md-sys-list-item-two-padding);
-    padding-block-end: var(--md-sys-list-item-two-padding);
 
-    &:has(.micl-list-item__thumbnail) {
-        padding-inline-start: 0px;
-        padding-block-start: 12px;
-        padding-block-end: 12px;
+    &:not(:has(> a, > label)) {
+        padding-block-start: var(--md-sys-list-item-two-padding);
+        padding-block-end: var(--md-sys-list-item-two-padding);
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-inline-start: 0px;
+            padding-block-start: 12px;
+            padding-block-end: 12px;
+        }
+    }
+    &> a,
+    &> label {
+        padding-block-start: var(--md-sys-list-item-two-padding);
+        padding-block-end: var(--md-sys-list-item-two-padding);
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-inline-start: 0px;
+            padding-block-start: 12px;
+            padding-block-end: 12px;
+        }
     }
     .micl-list-item__supporting-text {
         white-space: nowrap;
@@ -211,13 +257,27 @@
 }
 .micl-list-item-three {
     min-height: var(--md-sys-list-item-three-height);
-    padding-block-start: var(--md-sys-list-item-three-padding);
-    padding-block-end: var(--md-sys-list-item-three-padding);
 
-    &:has(.micl-list-item__thumbnail) {
+    &:not(:has(> a, > label)) {
+        padding-block-start: var(--md-sys-list-item-three-padding);
+        padding-block-end: var(--md-sys-list-item-three-padding);
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-block-start: var(--md-sys-list-item-three-padding);
+            padding-block-end: var(--md-sys-list-item-three-padding);
+            padding-inline-start: 0px;
+        }
+    }
+    &> a,
+    &> label {
         padding-block-start: var(--md-sys-list-item-three-padding);
         padding-block-end: var(--md-sys-list-item-three-padding);
-        padding-inline-start: 0px;
+
+        &:has(.micl-list-item__thumbnail) {
+            padding-block-start: var(--md-sys-list-item-three-padding);
+            padding-block-end: var(--md-sys-list-item-three-padding);
+            padding-inline-start: 0px;
+        }
     }
     .micl-list-item__icon,
     .micl-list-item__avatar,
@@ -230,7 +290,7 @@
         -webkit-box-orient: vertical;
         -webkit-line-clamp: 2;
     }
-    input[type=checkbox].micl-checkbox {
+    input[type=checkbox] {
         align-self: flex-start;
         margin-block-start: -12px;
     }
@@ -238,37 +298,39 @@
 
 .micl-list-item__icon {
     color: var(--md-sys-color-on-surface-variant);
+    font-size: 24px;
     font-variation-settings: 'FILL' 0;
     transition: font-variation-settings var(--md-sys-motion-duration-long2) linear;
 }
 .micl-list-item__avatar {
-    font-size: 40px;
-    border-radius: var(--md-sys-shape-corner-full);
-    color: var(--md-sys-color-primary-container);
-}
-.micl-list-item__avatar-text {
     @include typography.title-medium;
 
-    color: var(--md-sys-on-primary-container);
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    block-size: 40px;
+    min-inline-size: 40px;
+    border-radius: var(--md-sys-shape-corner-full);
+    color: var(--md-sys-color-on-primary-container);
+    background-color: var(--md-sys-color-primary-container);
 }
 .micl-list-item__image {
     display: inline-block;
-    width: 56px;
     height: 56px;
     min-width: 56px;
-    min-height: 56px;
     border-radius: var(--md-sys-shape-corner-none);
+    background-position: center;
+    background-repeat: no-repeat;
     background-size: cover;
 }
 .micl-list-item__thumbnail {
     display: inline-block;
-    width: auto;
     height: 64px;
-    min-height: 64px;
-    aspect-ratio: 1.5;
+    min-width: calc(64px * var(--md-sys-list-item-thumbnail-aspect-ratio));
     border-radius: var(--md-sys-shape-corner-none);
-    background-size: contain;
+    background-position: center;
     background-repeat: no-repeat;
+    background-size: contain;
 }
 
 .micl-list-item__text {

package/components/list/index.ts

@@ -91,7 +91,7 @@ export default (() =>
                     break;
                 case 'Enter':
                 case ' ':
-                    const cb = (event.target as Element).querySelector('input[type=checkbox].micl-checkbox');
+                    const cb = (event.target as Element).querySelector('input[type=checkbox]');
                     if (cb instanceof HTMLInputElement) {
                         cb.checked = !cb.checked;
                     }

package/components/menu/index.scss

@@ -33,13 +33,13 @@
     position-try-fallbacks: flip-block, flip-inline;
     min-width: 112px;
     max-width: 280px;
-    padding-block: 8px;
     padding-inline: 0;
     border: none;
     border-radius: var(--md-sys-shape-corner-extra-small);
     background-color: var(--md-sys-color-surface-container);
     box-shadow: var(--md-sys-elevation-level2);
     opacity: 0;
+    overflow: hidden;
     transform: scaleY(0);
     transform-origin: top left;
     transition:
@@ -90,7 +90,7 @@
         --md-sys-list-item-one-padding: 0;
         --md-sys-list-item-two-padding: 0;
         --md-sys-list-item-space: 12px;
-        --md-sys-list-item-background-color: var(--md-sys-color-surface-container);
+        --md-sys-list-item-container-color: var(--md-sys-color-surface-container);
 
         .micl-list-item-one,
         .micl-list-item-two,

package/components/select/index.scss

@@ -63,7 +63,7 @@
         --md-sys-list-item-two-padding: 0;
         --md-sys-list-item-space: 12px;
         --md-sys-list-item-padding-inline: 16px;
-        --md-sys-list-item-background-color: var(--md-sys-color-surface-container);
+        --md-sys-list-item-container-color: var(--md-sys-color-surface-container);
         --md-sys-motion-duration-long2: 500ms;
         --md-sys-state-hover-state-layer-opacity: #{statelayer.$md-sys-state-hover-state-layer-opacity};
         --md-sys-state-focus-state-layer-opacity: #{statelayer.$md-sys-state-focus-state-layer-opacity};

package/components/slider/README.md

@@ -65,3 +65,11 @@ The Slider component is aware of the `dir` global attribute that indicates the d
 
 ## Compatibility
 This component uses the `color-mix` CSS functional notation, which might not be supported in your browser. Please check [Browser compatibility](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color-mix#browser_compatibility) for details.
+
+> [!NOTE]
+> **Gecko browsers** The Slider component uses the `::after` pseudo-element to display the value indicator. For this to work on **Gecko** browsers, like Mozilla Firefox, wrap the Slider component inside a slider container:
+```HTML
+<div class="micl-slider__container">
+  <input type="range" class="micl-slider-l" value="0">
+</div>
+```