Add the row layout component
Plan step 35: <x-row gap align justify wrap stack-below>, children side by side in a pane and stacked under one another below an M3 breakpoint, in the inline direction so a right-to-left document mirrors it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qwx5USif3wFFmxtHg5U1g9
This commit is contained in:
Andreas Reinhold / reini
co-authored by
Claude Opus 5
Claude Opus 5
parent
b677e60876
commit
8de053f15c
@@ -787,6 +787,14 @@ M3's margin — 16px on a compact window, 24px from `medium` — is drawn once:
|
||||
|
||||
Children one under another inside a pane: `<x-stack gap="space200">…</x-stack>`. `align` across it: `stretch` (default), `start`, `center`, `end`.
|
||||
|
||||
#### `<x-row>`
|
||||
|
||||
Children side by side inside a pane: `<x-row gap="space100" justify="between" stack-below="medium">…</x-row>`.
|
||||
|
||||
- `align` across it: `center` (default), `start`, `end`, `stretch`, `baseline`. `justify` along it: `start` (default), `center`, `end`, `between`. `wrap` lets them wrap.
|
||||
- `stack-below`: `medium`, `expanded`, `large` or `extra-large` — below that breakpoint the row is a column, its children stretched unless `align` was given.
|
||||
- It runs in the inline direction, so it mirrors in a right-to-left document by itself.
|
||||
|
||||
### `<x-app-shell>`
|
||||
|
||||
The adaptive app shell, a whole layout's body: one navigation per M3 window size class, the page as `<main id="content" wire:transition.navigate>` behind a skip link, and the snackbar host (do not add another `<x-toast />`). It needs `<x-theme-script />` in `<head>`.
|
||||
|
||||
@@ -7,3 +7,4 @@
|
||||
@layer material.reset, material.tokens, material.base, material.layout, material.components, material.text, material.visibility;
|
||||
|
||||
@import './layout/stack.css';
|
||||
@import './layout/row.css';
|
||||
|
||||
@@ -0,0 +1,111 @@
|
||||
/*
|
||||
* <x-row>: its children side by side, in a pane, stacked under one another below a breakpoint.
|
||||
*
|
||||
* A flex row in the inline direction, so it runs right to left in a right-to-left document, as M3's
|
||||
* bidirectionality rules ask of every layout (docs/reference/m3/foundations.md § Layout →
|
||||
* Bidirectionality / RTL). Children are centred across the row unless `data-md-align` says
|
||||
* `start`, `end`, `stretch` or `baseline`; `data-md-justify` places them along it (`start`,
|
||||
* `center`, `end`, `between`); `data-md-wrap` lets them wrap. The space between them is `--md-gap`
|
||||
* (spacing.css).
|
||||
*
|
||||
* `data-md-stack-below` turns the row into a column on a window narrower than the breakpoint it
|
||||
* names (M3's, in px: medium 600, expanded 840, large 1200, extra-large 1600) — M3's "reposition"
|
||||
* as the window shrinks (§ Layout → Breakpoints). A stacked row stretches its children across its
|
||||
* width unless an `align` was given.
|
||||
*
|
||||
* In `material.layout`; `hide-below`/`hide-from` come from visibility.css.
|
||||
*/
|
||||
|
||||
@layer material.reset, material.tokens, material.base, material.layout, material.components, material.text, material.visibility;
|
||||
|
||||
@import './spacing.css';
|
||||
@import './visibility.css';
|
||||
|
||||
@layer material.layout {
|
||||
:where([data-md-row]) {
|
||||
--md-gap: 0px;
|
||||
}
|
||||
|
||||
[data-md-row] {
|
||||
display: flex;
|
||||
flex-direction: row;
|
||||
align-items: center;
|
||||
gap: var(--md-gap);
|
||||
}
|
||||
|
||||
[data-md-row][data-md-align='start'] {
|
||||
align-items: flex-start;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-align='end'] {
|
||||
align-items: flex-end;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-align='stretch'] {
|
||||
align-items: stretch;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-align='baseline'] {
|
||||
align-items: baseline;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-justify='start'] {
|
||||
justify-content: flex-start;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-justify='center'] {
|
||||
justify-content: center;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-justify='end'] {
|
||||
justify-content: flex-end;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-justify='between'] {
|
||||
justify-content: space-between;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-wrap] {
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
@media (width < 600px) {
|
||||
[data-md-row][data-md-stack-below='medium'] {
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-stack-below='medium']:not([data-md-align]) {
|
||||
align-items: stretch;
|
||||
}
|
||||
}
|
||||
|
||||
@media (width < 840px) {
|
||||
[data-md-row][data-md-stack-below='expanded'] {
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-stack-below='expanded']:not([data-md-align]) {
|
||||
align-items: stretch;
|
||||
}
|
||||
}
|
||||
|
||||
@media (width < 1200px) {
|
||||
[data-md-row][data-md-stack-below='large'] {
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-stack-below='large']:not([data-md-align]) {
|
||||
align-items: stretch;
|
||||
}
|
||||
}
|
||||
|
||||
@media (width < 1600px) {
|
||||
[data-md-row][data-md-stack-below='extra-large'] {
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
[data-md-row][data-md-stack-below='extra-large']:not([data-md-align]) {
|
||||
align-items: stretch;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,44 @@
|
||||
{{-- Children side by side, inside a pane; under one another below a breakpoint.
|
||||
|
||||
<x-row gap="space100" justify="end" stack-below="medium">…</x-row>
|
||||
|
||||
`gap` is a spacing token's name, `space25` … `space900` (docs/reference/m3/styles-supplement.md
|
||||
§ Spacing), and none when left out or unknown. `align` places the children across the row:
|
||||
`center` (the default), `start`, `end`, `stretch` or `baseline`. `justify` places them along
|
||||
it: `start` (the default), `center`, `end` or `between`. `wrap` lets them wrap onto more lines.
|
||||
|
||||
`stack-below` names a breakpoint — `medium` (600px), `expanded` (840), `large` (1200) or
|
||||
`extra-large` (1600), M3's in px (docs/reference/m3/foundations.md § Layout → Breakpoints) —
|
||||
below which the row is a column: M3's "reposition" as the window narrows. A stacked row
|
||||
stretches its children unless `align` was given.
|
||||
|
||||
The row runs in the inline direction, so it mirrors in a right-to-left document by itself. It
|
||||
takes `as`, `hide-below` and `hide-from` like every layout component, and the caller's `class`
|
||||
and `style` land on it untouched. Drawn by resources/css/layout/row.css. --}}
|
||||
|
||||
@props([
|
||||
'as' => null,
|
||||
'gap' => null,
|
||||
'align' => null,
|
||||
'justify' => null,
|
||||
'wrap' => false,
|
||||
'stackBelow' => null,
|
||||
'hideBelow' => null,
|
||||
'hideFrom' => null,
|
||||
])
|
||||
|
||||
@php
|
||||
$layout = \NoNameWeb\LivewireMaterial\Support\Layout::class;
|
||||
$element = $layout::element($as);
|
||||
|
||||
$attributes = $attributes->merge(array_filter([
|
||||
'data-md-row' => true,
|
||||
'data-md-gap' => $layout::spacing($gap),
|
||||
'data-md-align' => $layout::choice($align, ['center', 'start', 'end', 'stretch', 'baseline']),
|
||||
'data-md-justify' => $layout::choice($justify, ['start', 'center', 'end', 'between']),
|
||||
'data-md-wrap' => $wrap ? true : null,
|
||||
'data-md-stack-below' => $layout::edge($stackBelow),
|
||||
] + $layout::visibility($hideBelow, $hideFrom), fn ($value): bool => $value !== null));
|
||||
@endphp
|
||||
|
||||
<{{ $element }} {{ $attributes }}>{{ $slot }}</{{ $element }}>
|
||||
Reference in New Issue
Block a user