Plan step 36 ("Interaction is the shared classes", the user, 2026-09-14).
The trigger button (fab-menu.css) and each item (fab-menu-item.css)
hand-rolled md-state-layer and md-focus-ring; both now render the classes
and keep only their own colour, shape and motion. Neither needs
md-touch-target: the trigger and every item draw at 56px.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qwx5USif3wFFmxtHg5U1g9
79 lines
3.7 KiB
PHP
79 lines
3.7 KiB
PHP
{{-- An M3 Expressive FAB menu: a FAB that opens into a short list of related actions.
|
|
|
|
<div style="position: fixed; inset-inline-end: 16px; bottom: 16px">
|
|
<x-fab-menu label="New">
|
|
<x-fab-menu-item label="Upload files" icon="upload_file" wire:click="uploadFiles" />
|
|
<x-fab-menu-item label="Upload a folder" icon="drive_folder_upload" wire:click="uploadFolder" />
|
|
</x-fab-menu>
|
|
</div>
|
|
|
|
Two to six items. The FAB (`icon`, `add` by default, in `color`'s container) turns into a
|
|
round close button in the colour itself while the list is open above it, end-aligned; the
|
|
list is a `popover="auto"` menu with the menu keyboard of `<x-menu>`. `label` names the FAB
|
|
and the menu for screen readers, and defaults to "Toggle menu" (ACT-21) — the icons inside
|
|
the button are aria-hidden, so without it the trigger has no name at all. Give the items the
|
|
same `color`. Like `<x-menu>`'s, the list is keyed for Livewire, so it stays open through a
|
|
render of the component around it.
|
|
|
|
It does not place itself. M3's margin from the edge of the window is 16px, 24px from `large`
|
|
(1200px) up — grow it in the caller's own stylesheet:
|
|
|
|
@media (width >= 1200px) { .my-fab-menu { inset-inline-end: 24px; bottom: 24px } }
|
|
|
|
A window too short for the list scrolls it, behind the close button, which stays fixed
|
|
(ACT-32); the items rise into place as it opens and sink back as it closes (ACT-33).
|
|
|
|
FabMenuBaselineTokens (androidx Compose Material 3, Apache-2.0): 56px close button, full
|
|
corner when open, 20px close icon, 8px to the first item, 56px items 4px apart.
|
|
|
|
Drawn by resources/css/components/fab-menu.css from `data-md-fab-menu`, `data-md-color` and
|
|
`data-md-position`. --}}
|
|
|
|
@props([
|
|
'icon' => 'add',
|
|
'label' => null,
|
|
'color' => 'primary',
|
|
'position' => 'top-end',
|
|
])
|
|
|
|
@php
|
|
// The trigger's only content is two icons, which are aria-hidden, so without a name it is an
|
|
// unnamed button. M3 asks the FAB's label to say what menu it opens; "Toggle menu" is its own
|
|
// fallback wording for the close button.
|
|
$label = filled($label) ? $label : __('Toggle menu');
|
|
$color = in_array($color, ['primary', 'secondary', 'tertiary'], true) ? $color : 'primary';
|
|
$position = in_array($position, ['top-start', 'top-end', 'bottom-start', 'bottom-end'], true) ? $position : 'top-end';
|
|
$key = \Illuminate\Support\Str::lower(\Illuminate\Support\Str::random(10));
|
|
$anchor = "--material-fab-menu-{$key}";
|
|
@endphp
|
|
|
|
<div x-data="materialMenu" data-md-fab-menu {{ $attributes }}>
|
|
<span x-ref="trigger" data-md-fab-menu-anchor style="anchor-name: {{ $anchor }}"
|
|
x-on:click="toggle('first')"
|
|
x-on:keydown.down.prevent="open('first')"
|
|
x-on:keydown.up.prevent="open('last')"
|
|
>
|
|
<button type="button" class="md-state-layer md-focus-ring" aria-label="{{ $label }}" data-md-fab-menu-trigger data-md-color="{{ $color }}">
|
|
<x-livewire-material::icon :name="$icon" filled data-md-fab-menu-icon />
|
|
<x-livewire-material::icon name="close" filled size="20" data-md-fab-menu-close-icon />
|
|
</button>
|
|
</span>
|
|
|
|
<div
|
|
x-ref="menu"
|
|
{{ new \Illuminate\View\ComponentAttributeBag(['wire:key' => 'material-fab-menu']) }}
|
|
id="material-fab-menu-{{ $key }}"
|
|
popover="auto"
|
|
role="menu"
|
|
data-md-fab-menu-popover
|
|
data-md-position="{{ $position }}"
|
|
aria-label="{{ $label }}"
|
|
tabindex="-1"
|
|
style="position-anchor: {{ $anchor }}"
|
|
x-on:keydown="navigate($event)"
|
|
x-on:click="activate($event)"
|
|
>
|
|
{{ $slot }}
|
|
</div>
|
|
</div>
|