Add the M3 Expressive carousel

Multi-browse, hero, uncontained and full-screen layouts on a native scroll-snap row, with Compose's keyline maths masking each item as it scrolls. Completes Phase 5. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01V9NnLxnPp8vaaurb3Z1MFy
2026-09-13 07:40:30 +02:00
parent fef20a9178
commit ad724662ca
12 changed files with 1792 additions and 1 deletions
@@ -0,0 +1,50 @@
+{{-- One item of an `<x-carousel>`: a slide of art — an `<img>`, which fills and crops to the
+     item, or any element sized `size-full`.
+
+         <x-carousel-item label="Lake Constance">
+             <img src="{{ $photo->url }}" alt="Lake Constance at dusk" />
+         </x-carousel-item>
+
+     `label` lays a short line of text over the bottom of the art, on a scrim, pinned to the
+     item's visible edge and fading out as the item narrows — Compose's carousel sample, which
+     fades its label chip in once the mask is wide enough to hold it.
+
+     A `group` with `aria-roledescription="slide"`, named "n of m" by the carousel around it
+     (WAI-ARIA's carousel pattern). The item is laid out at the carousel's large size and masked:
+     the surface inside is clipped by `--material-carousel-inset` from both sides with M3's
+     extra-large corner (28px, CarouselDefaults' item shape) and moved by
+     `--material-carousel-shift`, both written by resources/js/carousel.js. Without script the
+     item shows unmasked, at its `item-width`. Only inside `<x-carousel>`. --}}
+
+@props([
+    'label' => null,
+])
+
+<div {{ $attributes
+    ->class([
+        'relative h-full w-(--material-carousel-slot) max-w-full shrink-0 snap-start snap-always',
+    ])
+    ->merge([
+        'role' => 'group',
+        'aria-roledescription' => __('slide'),
+        'aria-label' => '[material-carousel-position]',
+        'data-material-carousel-item' => true,
+    ]) }}>
+    <div
+        data-material-carousel-surface
+        class="relative size-full overflow-hidden rounded-corner-xl bg-surface-container-highest text-on-surface translate-x-(--material-carousel-shift) [clip-path:inset(0_var(--material-carousel-inset,0px)_round_var(--md-sys-shape-corner-xl))]"
+    >
+        <div data-material-carousel-content class="size-full translate-x-(--material-carousel-pin) [&>img]:size-full [&>img]:object-cover">
+            {{ $slot }}
+        </div>
+
+        @if (filled($label))
+            <div
+                data-material-carousel-label
+                class="pointer-events-none absolute inset-x-0 bottom-0 flex bg-linear-to-t from-scrim/60 to-transparent px-4 pt-10 pb-4 opacity-(--material-carousel-label)"
+            >
+                <span class="truncate type-title-md text-white translate-x-(--material-carousel-label-shift)">{{ $label }}</span>
+            </div>
+        @endif
+    </div>
+</div>