Andreas Reinhold / reiniandClaude Sonnet 5
487176d345
Plan step 38: the Layout section's Overview keeps its breakpoint
table and live "This window" readout (now a shared
<x-showcase::breakpoint-readout> partial, and the five breakpoint
cards a real range-queried data-md-showcase-breakpoint-card instead
of Tailwind's max-medium:/medium:max-expanded: variants), but the
three canonical layouts move off it onto a page of their own:
/material/layout/{list-detail,supporting-pane,feed}
(ShowcaseController::layout(), routes/showcase.php), each built on
the real component, sharing one <x-section-nav> Sections::
layoutPages() feeds. The search index gains an entry per page with
its own URL, and the component-homes scan now also reads the three
pages' own source so <x-list-detail>, <x-supporting-pane> and
<x-feed> keep a home.
The whole section moves onto the layout components and md-* classes:
no bespoke Tailwind grid or table styling remains.
LayoutTest's browser test now visits the three dedicated pages
instead of one shared /material/layout; a new Feature test asserts
each page renders and is linked from the Layout section.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qwx5USif3wFFmxtHg5U1g9
153 lines
7.6 KiB
PHP
153 lines
7.6 KiB
PHP
{{-- M3's breakpoints, live: the one this window is in, what each one changes, and the cards that
|
||
light up through real media queries, so the page proves the breakpoints rather than only
|
||
describing them.
|
||
|
||
Then the layout components, and the way on to the three canonical layouts — list-detail,
|
||
supporting pane, feed — each on a page of its own (plan step 38), reached through the
|
||
section navigation below. --}}
|
||
|
||
@php
|
||
$examples = [
|
||
'Surfaces, stacks, rows and grids' => <<<'BLADE'
|
||
<x-stack gap="space300">
|
||
<x-grid :columns="['compact' => 1, 'medium' => 2, 'expanded' => 4]" gap="space200">
|
||
<x-surface level="surface-container-lowest" padding="space200" corner="md" outlined><p class="md-type-label-lg">lowest, outlined</p></x-surface>
|
||
<x-surface level="surface-container-low" padding="space200" corner="md"><p class="md-type-label-lg">low</p></x-surface>
|
||
<x-surface level="surface-container-high" padding="space200" corner="md"><p class="md-type-label-lg">high</p></x-surface>
|
||
<x-surface level="surface-container-highest" padding="space200" corner="md"><p class="md-type-label-lg">highest</p></x-surface>
|
||
</x-grid>
|
||
|
||
<x-row gap="space200" justify="between" stack-below="medium">
|
||
<x-stack gap="space50">
|
||
<p class="md-type-title-md">A row that stacks below 600px</p>
|
||
<p class="md-type-body-md md-ink-variant">Its middle item is hidden from 840px.</p>
|
||
</x-stack>
|
||
<x-stack hide-from="expanded"><p class="md-type-body-sm md-ink-variant">Widen the window past 840px and this goes.</p></x-stack>
|
||
<x-button label="Save" variant="filled" />
|
||
</x-row>
|
||
</x-stack>
|
||
BLADE,
|
||
];
|
||
@endphp
|
||
|
||
<x-livewire-material::stack as="section" id="layout" gap="space300">
|
||
<h2 class="md-type-headline-md">Layout</h2>
|
||
|
||
<p class="md-type-body-md md-ink-variant">
|
||
Widths are M3's breakpoints and nothing else: compact below 600px, then medium 600, expanded 840, large 1200
|
||
and extra-large 1600. Scripts read the same numbers from <code>resources/js/breakpoints.js</code>.
|
||
</p>
|
||
|
||
<x-showcase::breakpoint-readout />
|
||
|
||
<x-livewire-material::grid :columns="['compact' => 1, 'medium' => 5]" gap="space200">
|
||
<div data-md-showcase-breakpoint-card="compact">
|
||
<p class="md-type-title-sm">Compact</p>
|
||
<p class="md-type-body-sm">below 600px</p>
|
||
</div>
|
||
<div data-md-showcase-breakpoint-card="medium">
|
||
<p class="md-type-title-sm">Medium</p>
|
||
<p class="md-type-body-sm">600–839px</p>
|
||
</div>
|
||
<div data-md-showcase-breakpoint-card="expanded">
|
||
<p class="md-type-title-sm">Expanded</p>
|
||
<p class="md-type-body-sm">840–1199px</p>
|
||
</div>
|
||
<div data-md-showcase-breakpoint-card="large">
|
||
<p class="md-type-title-sm">Large</p>
|
||
<p class="md-type-body-sm">1200–1599px</p>
|
||
</div>
|
||
<div data-md-showcase-breakpoint-card="extra-large">
|
||
<p class="md-type-title-sm">Extra-large</p>
|
||
<p class="md-type-body-sm">from 1600px</p>
|
||
</div>
|
||
</x-livewire-material::grid>
|
||
|
||
<x-livewire-material::surface corner="lg" outlined style="overflow-x: auto">
|
||
<x-livewire-material::table>
|
||
<thead>
|
||
<tr>
|
||
<th>Class</th>
|
||
<th>Navigation</th>
|
||
<th>Panes</th>
|
||
<th>Dialogs and sheets</th>
|
||
<th>Margin</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr>
|
||
<td>Compact</td>
|
||
<td>Navigation bar; the rail opens as a modal</td>
|
||
<td>One</td>
|
||
<td>Full-screen dialogs, bottom sheets for choices, date pickers as dialogs</td>
|
||
<td>16px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Medium</td>
|
||
<td>Collapsed navigation rail</td>
|
||
<td>One</td>
|
||
<td>Basic dialogs, docked search and pickers</td>
|
||
<td>24px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Expanded</td>
|
||
<td>Navigation rail, collapsible; starts collapsed</td>
|
||
<td>Two: <code><x-list-detail></code>, or <code><x-supporting-pane></code> at 360px</td>
|
||
<td>Basic dialogs, side sheets</td>
|
||
<td>24px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Large</td>
|
||
<td>Navigation rail, expanded by default</td>
|
||
<td>Two; a fixed pane is 412px</td>
|
||
<td>Basic dialogs, side sheets</td>
|
||
<td>24px</td>
|
||
</tr>
|
||
<tr>
|
||
<td>Extra-large</td>
|
||
<td>Navigation rail, expanded</td>
|
||
<td>Two, a third as a side sheet</td>
|
||
<td>Basic dialogs, side sheets</td>
|
||
<td>24px</td>
|
||
</tr>
|
||
</tbody>
|
||
</x-livewire-material::table>
|
||
</x-livewire-material::surface>
|
||
|
||
<p class="md-type-body-md md-ink-variant">
|
||
<code><x-scaffold></code> does all of this: resize this showcase and watch the bar, the rail and the
|
||
content margin (<code>--material-margin</code>) change at 600, 840 and 1200px. A visitor who has chosen a rail
|
||
width keeps it; until then the rail follows the class.
|
||
</p>
|
||
|
||
<x-livewire-material::stack gap="space200" data-test="layout-components">
|
||
<h3 class="md-type-title-lg">The layout components</h3>
|
||
|
||
<p class="md-type-body-md md-ink-variant">
|
||
M3 describes a layout as a scaffold of bars and rails around panes, and names three canonical layouts. These are
|
||
those words as components, each taking <code>as</code>, <code>hide-below</code> and <code>hide-from</code>, and
|
||
only the spacing tokens for a gap or padding:
|
||
</p>
|
||
|
||
<x-livewire-material::stack as="ul" gap="space100" class="md-type-body-md">
|
||
<li><code><x-scaffold></code> — the bars, the rail and the FAB around the page (this showcase is one).</li>
|
||
<li><code><x-pane></code> — a content region with M3's margins and its own app bar.</li>
|
||
<li><code><x-list-detail></code> — a list and the detail of its selection: one pane below 840px, two from it.</li>
|
||
<li><code><x-supporting-pane></code> — a focus pane and a pane beside it from 840px, below it or a bottom sheet before.</li>
|
||
<li><code><x-feed></code> — cards in columns that multiply as the room grows, one column below 600px.</li>
|
||
<li><code><x-surface></code> — a tonal region: a surface role, padding, a corner and an outline.</li>
|
||
<li><code><x-stack></code>, <code><x-row></code> and <code><x-grid></code> — arrangement inside a pane.</li>
|
||
</x-livewire-material::stack>
|
||
</x-livewire-material::stack>
|
||
|
||
<x-livewire-material::stack gap="space200">
|
||
<h3 class="md-type-title-lg">Each canonical layout, on a page of its own</h3>
|
||
|
||
<x-livewire-material::section-nav :items="array_values(\NoNameWeb\LivewireMaterial\Showcase\Sections::layoutPages())" label="Layout pages" />
|
||
</x-livewire-material::stack>
|
||
|
||
@foreach ($examples as $title => $code)
|
||
<x-showcase::example :$title :$code stack />
|
||
@endforeach
|
||
</x-livewire-material::stack>
|