Add data tables, sort headers and M3 paginators

A data table styled from descendant selectors, a Livewire sort header with aria-sort, and Laravel's and Livewire's full and simple paginators drawn in M3, put in front of their own views. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01V9NnLxnPp8vaaurb3Z1MFy
2026-09-13 08:32:59 +02:00
parent f90695cedd
commit 83ed671c4e
16 changed files with 613 additions and 1 deletions
@@ -0,0 +1,37 @@
+{{-- A column header that sorts the table, bound to a Livewire property shaped
+     `['column' => …, 'direction' => 'asc'|'desc']` — `sortBy` by default, or the one `model` names.
+
+     Pressing it sorts by this column, ascending first and then flipping; the arrow says which way,
+     and `aria-sort` says it to a screen reader. A column that cannot be sorted is a plain `<th>`.
+     `class` lands on the `<th>` (`text-end` for a number column moves the button with it). --}}
+
+@props([
+    'sortBy' => [],
+    'column',
+    'model' => 'sortBy',
+])
+
+@php
+    $active = ($sortBy['column'] ?? null) === $column;
+    $direction = $active ? (($sortBy['direction'] ?? 'asc') === 'desc' ? 'desc' : 'asc') : null;
+    $next = $active && $direction === 'asc' ? 'desc' : 'asc';
+@endphp
+
+<th @if ($active) aria-sort="{{ $direction === 'asc' ? 'ascending' : 'descending' }}" @endif {{ $attributes }}>
+    <button
+        type="button"
+        wire:click="$set('{{ $model }}', {{ json_encode(['column' => $column, 'direction' => $next]) }})"
+        data-sort-header
+        @class([
+            'group/sort focus-ring inline-flex cursor-pointer items-center gap-1 rounded-corner-xs',
+            'text-on-surface' => $active,
+            'hover:text-on-surface' => ! $active,
+        ])
+    >
+        {{ $slot }}
+        <x-icon :name="$direction === 'desc' ? 'arrow_downward' : 'arrow_upward'" :class="\Illuminate\Support\Arr::toCssClasses([
+            'size-4 transition-opacity duration-(--md-sys-motion-effects-fast-duration)',
+            'opacity-0 group-hover/sort:opacity-60 group-focus-visible/sort:opacity-60' => ! $active,
+        ])" />
+    </button>
+</th>
@@ -0,0 +1,16 @@
+{{-- A data table. Its callers write `<thead>`, `<tr>`, `<th>` and `<td>` as they always do; how they
+     look is resources/css/components/table.css, keyed on the `data-table` attribute set here (the
+     top of that file says why).
+
+     `size="xs"` for a table inside a panel inside a panel. A selected row is
+     `<tr aria-selected="true">`. Horizontal scrolling stays the caller's — wrap the table in
+     `<div class="overflow-x-auto">` where the page needs it. A column that sorts is
+     `<x-sort-header>`. --}}
+
+@props([
+    'size' => 'sm',
+])
+
+<table data-table data-size="{{ $size === 'xs' ? 'xs' : 'sm' }}" {{ $attributes }}>
+    {{ $slot }}
+</table>
@@ -0,0 +1,18 @@
+{{-- Laravel's simple and cursor paginator, drawn in M3: previous and next as outlined buttons
+     (the package puts this in front of `pagination::simple-tailwind`). --}}
+
+@if ($paginator->hasPages())
+    <nav role="navigation" aria-label="{{ __('Pagination Navigation') }}" data-pagination class="flex items-center justify-between gap-4">
+        @if ($paginator->onFirstPage())
+            <x-button variant="outlined" icon="chevron_left" :label="__('Previous')" disabled />
+        @else
+            <x-button variant="outlined" icon="chevron_left" :label="__('Previous')" :link="$paginator->previousPageUrl()" no-wire-navigate rel="prev" />
+        @endif
+
+        @if ($paginator->hasMorePages())
+            <x-button variant="outlined" icon-right="chevron_right" :label="__('Next')" :link="$paginator->nextPageUrl()" no-wire-navigate rel="next" />
+        @else
+            <x-button variant="outlined" icon-right="chevron_right" :label="__('Next')" disabled />
+        @endif
+    </nav>
+@endif
@@ -0,0 +1,57 @@
+{{-- Laravel's paginator (`$items->links()` outside Livewire), drawn in M3 as Livewire's is
+     (resources/views/pagination/livewire/tailwind.blade.php): links instead of actions, the current
+     page in secondary-container, "Page 2 of 7" on a phone. The package puts this in front of
+     `pagination::tailwind` (config `livewire-material.pagination`). --}}
+
+@php
+    $step = 'grid size-10 place-items-center rounded-corner-full type-label-lg tabular-nums';
+    $live = $step.' state-layer focus-ring text-on-surface';
+    $dead = $step.' text-on-surface/38';
+@endphp
+
+@if ($paginator->hasPages())
+    <nav role="navigation" aria-label="{{ __('Pagination Navigation') }}" data-pagination class="flex items-center justify-between gap-4">
+        <p class="type-body-sm text-on-surface-variant">
+            <span class="sm:hidden">{{ __('Page :page of :pages', ['page' => $paginator->currentPage(), 'pages' => $paginator->lastPage()]) }}</span>
+            <span class="max-sm:hidden">{{ __(':first–:last of :total', ['first' => $paginator->firstItem(), 'last' => $paginator->lastItem(), 'total' => $paginator->total()]) }}</span>
+        </p>
+
+        <div class="flex items-center gap-1">
+            @if ($paginator->onFirstPage())
+                <span class="{{ $dead }}" aria-disabled="true" aria-label="{{ __('Previous') }}">
+                    <x-icon name="chevron_left" class="size-6 rtl:-scale-x-100" />
+                </span>
+            @else
+                <a href="{{ $paginator->previousPageUrl() }}" rel="prev" class="{{ $live }}" aria-label="{{ __('Previous') }}">
+                    <x-icon name="chevron_left" class="size-6 rtl:-scale-x-100" />
+                </a>
+            @endif
+
+            @foreach ($elements as $element)
+                @if (is_string($element))
+                    <span class="{{ $dead }} max-sm:hidden" aria-disabled="true">{{ $element }}</span>
+                @endif
+
+                @if (is_array($element))
+                    @foreach ($element as $page => $url)
+                        @if ($page == $paginator->currentPage())
+                            <span aria-current="page" class="{{ $step }} bg-secondary-container text-on-secondary-container max-sm:hidden">{{ $page }}</span>
+                        @else
+                            <a href="{{ $url }}" class="{{ $live }} max-sm:hidden" aria-label="{{ __('Go to page :page', ['page' => $page]) }}">{{ $page }}</a>
+                        @endif
+                    @endforeach
+                @endif
+            @endforeach
+
+            @if ($paginator->hasMorePages())
+                <a href="{{ $paginator->nextPageUrl() }}" rel="next" class="{{ $live }}" aria-label="{{ __('Next') }}">
+                    <x-icon name="chevron_right" class="size-6 rtl:-scale-x-100" />
+                </a>
+            @else
+                <span class="{{ $dead }}" aria-disabled="true" aria-label="{{ __('Next') }}">
+                    <x-icon name="chevron_right" class="size-6 rtl:-scale-x-100" />
+                </span>
+            @endif
+        </div>
+    </nav>
+@endif
@@ -0,0 +1,40 @@
+{{-- Livewire's simple and cursor paginator, drawn in M3: previous and next as outlined buttons
+     (the package puts this in front of `livewire::simple-tailwind`). --}}
+
+@php
+    if (! isset($scrollTo)) {
+        $scrollTo = 'body';
+    }
+
+    $scrollIntoViewJsSnippet = ($scrollTo !== false)
+        ? <<<JS
+           (\$el.closest('{$scrollTo}') || document.querySelector('{$scrollTo}')).scrollIntoView()
+        JS
+        : '';
+
+    $cursor = method_exists($paginator, 'getCursorName');
+@endphp
+
+<div>
+    @if ($paginator->hasPages())
+        <nav role="navigation" aria-label="{{ __('Pagination Navigation') }}" data-pagination class="flex items-center justify-between gap-4">
+            @if ($paginator->onFirstPage())
+                <x-button variant="outlined" icon="chevron_left" :label="__('Previous')" disabled />
+            @elseif ($cursor)
+                @php($previousCursor = $paginator->previousCursor() ?? $paginator->cursor())
+                <x-button variant="outlined" icon="chevron_left" :label="__('Previous')" wire:key="cursor-{{ $paginator->getCursorName() }}-{{ $previousCursor?->encode() }}" wire:click="setPage('{{ $previousCursor?->encode() }}', '{{ $paginator->getCursorName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="previousPage" />
+            @else
+                <x-button variant="outlined" icon="chevron_left" :label="__('Previous')" wire:click="previousPage('{{ $paginator->getPageName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="previousPage" />
+            @endif
+
+            @if (! $paginator->hasMorePages())
+                <x-button variant="outlined" icon-right="chevron_right" :label="__('Next')" disabled />
+            @elseif ($cursor)
+                @php($nextCursor = $paginator->nextCursor() ?? $paginator->cursor())
+                <x-button variant="outlined" icon-right="chevron_right" :label="__('Next')" wire:key="cursor-{{ $paginator->getCursorName() }}-{{ $nextCursor?->encode() }}" wire:click="setPage('{{ $nextCursor?->encode() }}', '{{ $paginator->getCursorName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="nextPage" />
+            @else
+                <x-button variant="outlined" icon-right="chevron_right" :label="__('Next')" wire:click="nextPage('{{ $paginator->getPageName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="nextPage" />
+            @endif
+        </nav>
+    @endif
+</div>
@@ -0,0 +1,76 @@
+{{-- Livewire's paginator, drawn in M3. The package puts this in front of Livewire's own
+     `livewire::tailwind` (config `livewire-material.pagination`), whose gray and blue classes do
+     not exist in an M3 theme.
+
+     The wiring is Livewire's, unchanged: `previousPage`, `nextPage` and `gotoPage` with the page
+     name, and the scroll back to the top of whatever `scrollTo` names. Page numbers are 40px
+     icon-button targets; the current one is the selected state, secondary-container, never the
+     action colour — it is where you are, not what to do next. On a phone the numbers give way to
+     "Page 2 of 7". --}}
+
+@php
+    if (! isset($scrollTo)) {
+        $scrollTo = 'body';
+    }
+
+    $scrollIntoViewJsSnippet = ($scrollTo !== false)
+        ? <<<JS
+           (\$el.closest('{$scrollTo}') || document.querySelector('{$scrollTo}')).scrollIntoView()
+        JS
+        : '';
+
+    $step = 'grid size-10 place-items-center rounded-corner-full type-label-lg tabular-nums';
+    $live = $step.' state-layer focus-ring cursor-pointer text-on-surface';
+    $dead = $step.' text-on-surface/38';
+@endphp
+
+<div>
+    @if ($paginator->hasPages())
+        <nav role="navigation" aria-label="{{ __('Pagination Navigation') }}" data-pagination class="flex items-center justify-between gap-4">
+            <p class="type-body-sm text-on-surface-variant">
+                <span class="sm:hidden">{{ __('Page :page of :pages', ['page' => $paginator->currentPage(), 'pages' => $paginator->lastPage()]) }}</span>
+                <span class="max-sm:hidden">{{ __(':first–:last of :total', ['first' => $paginator->firstItem(), 'last' => $paginator->lastItem(), 'total' => $paginator->total()]) }}</span>
+            </p>
+
+            <div class="flex items-center gap-1">
+                @if ($paginator->onFirstPage())
+                    <span class="{{ $dead }}" aria-disabled="true" aria-label="{{ __('Previous') }}">
+                        <x-icon name="chevron_left" class="size-6 rtl:-scale-x-100" />
+                    </span>
+                @else
+                    <button type="button" wire:click="previousPage('{{ $paginator->getPageName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="previousPage{{ $paginator->getPageName() == 'page' ? '' : '.'.$paginator->getPageName() }}" class="{{ $live }}" aria-label="{{ __('Previous') }}">
+                        <x-icon name="chevron_left" class="size-6 rtl:-scale-x-100" />
+                    </button>
+                @endif
+
+                @foreach ($elements as $element)
+                    @if (is_string($element))
+                        <span class="{{ $dead }} max-sm:hidden" aria-disabled="true">{{ $element }}</span>
+                    @endif
+
+                    @if (is_array($element))
+                        @foreach ($element as $page => $url)
+                            <span wire:key="paginator-{{ $paginator->getPageName() }}-page{{ $page }}" class="max-sm:hidden">
+                                @if ($page == $paginator->currentPage())
+                                    <span aria-current="page" class="{{ $step }} bg-secondary-container text-on-secondary-container">{{ $page }}</span>
+                                @else
+                                    <button type="button" wire:click="gotoPage({{ $page }}, '{{ $paginator->getPageName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" class="{{ $live }}" aria-label="{{ __('Go to page :page', ['page' => $page]) }}">{{ $page }}</button>
+                                @endif
+                            </span>
+                        @endforeach
+                    @endif
+                @endforeach
+
+                @if ($paginator->hasMorePages())
+                    <button type="button" wire:click="nextPage('{{ $paginator->getPageName() }}')" x-on:click="{{ $scrollIntoViewJsSnippet }}" wire:loading.attr="disabled" dusk="nextPage{{ $paginator->getPageName() == 'page' ? '' : '.'.$paginator->getPageName() }}" class="{{ $live }}" aria-label="{{ __('Next') }}">
+                        <x-icon name="chevron_right" class="size-6 rtl:-scale-x-100" />
+                    </button>
+                @else
+                    <span class="{{ $dead }}" aria-disabled="true" aria-label="{{ __('Next') }}">
+                        <x-icon name="chevron_right" class="size-6 rtl:-scale-x-100" />
+                    </span>
+                @endif
+            </div>
+        </nav>
+    @endif
+</div>
@@ -22,5 +22,6 @@
        @include('livewire-material::showcase.sections.chips')
        @include('livewire-material::showcase.sections.sliders')
        @include('livewire-material::showcase.sections.bars')
+        @include('livewire-material::showcase.sections.data')
    </main>
@endsection
@@ -18,7 +18,7 @@
                <a href="{{ route('livewire-material.showcase') }}" class="shrink-0 type-title-lg max-sm:hidden">Livewire Material</a>

                <nav class="-my-2 flex min-w-0 flex-1 gap-x-4 overflow-x-auto py-2 whitespace-nowrap type-label-lg text-on-surface-variant [scrollbar-width:none]" aria-label="Sections">
-                    @foreach (['colour' => 'Colour', 'type' => 'Type', 'shape' => 'Shape', 'elevation' => 'Elevation', 'motion' => 'Motion', 'icons' => 'Icons', 'buttons' => 'Buttons', 'menus' => 'Menus', 'communication' => 'Communication', 'progress' => 'Progress', 'containment' => 'Containment', 'carousel' => 'Carousel', 'fields' => 'Fields', 'chips' => 'Chips', 'sliders' => 'Sliders', 'bars' => 'Bars'] as $anchor => $section)
+                    @foreach (['colour' => 'Colour', 'type' => 'Type', 'shape' => 'Shape', 'elevation' => 'Elevation', 'motion' => 'Motion', 'icons' => 'Icons', 'buttons' => 'Buttons', 'menus' => 'Menus', 'communication' => 'Communication', 'progress' => 'Progress', 'containment' => 'Containment', 'carousel' => 'Carousel', 'fields' => 'Fields', 'chips' => 'Chips', 'sliders' => 'Sliders', 'bars' => 'Bars', 'data' => 'Data'] as $anchor => $section)
                        <a href="#{{ $anchor }}" class="rounded-corner-xs hover:text-on-surface focus-ring">{{ $section }}</a>
                    @endforeach
                </nav>
@@ -0,0 +1,56 @@
+@php
+    $examples = [
+        'Data table' => <<<'BLADE'
+            <div class="w-full overflow-x-auto">
+                <x-table>
+                    <thead>
+                        <tr>
+                            <x-sort-header column="name" :sort-by="['column' => 'name', 'direction' => 'asc']">Name</x-sort-header>
+                            <x-sort-header column="size" :sort-by="['column' => 'name', 'direction' => 'asc']" class="text-end">Size</x-sort-header>
+                            <th>Expires</th>
+                            <th><span class="sr-only">Actions</span></th>
+                        </tr>
+                    </thead>
+                    <tbody>
+                        <tr data-list-row>
+                            <td><a href="#data" data-list-open>contract.pdf</a></td>
+                            <td class="text-end tabular-nums">1.2 MB</td>
+                            <td>in 1 hour</td>
+                            <td class="text-end"><x-button icon="more_vert" tooltip="More" /></td>
+                        </tr>
+                        <tr data-list-row aria-selected="true">
+                            <td><a href="#data" data-list-open>design-review.mp4</a></td>
+                            <td class="text-end tabular-nums">3.4 GB</td>
+                            <td>in 7 days</td>
+                            <td class="text-end"><x-button icon="more_vert" tooltip="More" /></td>
+                        </tr>
+                        <tr data-list-row>
+                            <td><a href="#data" data-list-open>holiday-photos.zip</a></td>
+                            <td class="text-end tabular-nums">248 MB</td>
+                            <td>in 3 days</td>
+                            <td class="text-end"><x-button icon="more_vert" tooltip="More" /></td>
+                        </tr>
+                    </tbody>
+                </x-table>
+            </div>
+            BLADE,
+        'Pagination' => <<<'BLADE'
+            <div class="grid w-full gap-6">
+                {{ (new \Illuminate\Pagination\LengthAwarePaginator(range(1, 10), 95, 10, 3, ['path' => '#data']))->links() }}
+                {{ (new \Illuminate\Pagination\Paginator(range(1, 11), 10, 2, ['path' => '#data']))->links() }}
+            </div>
+            BLADE,
+    ];
+@endphp
+
+<section id="data" class="scroll-mt-24 space-y-6">
+    <h2 class="type-headline-md">Data</h2>
+
+    <p class="max-w-3xl type-body-md text-on-surface-variant">
+        <code>&lt;x-table&gt;</code>, <code>&lt;x-sort-header&gt;</code>, and Laravel's and Livewire's paginators.
+    </p>
+
+    @foreach ($examples as $title => $code)
+        <x-showcase::example :$title :$code />
+    @endforeach
+</section>