Compose a floating action button with SpeedDialTrigger, then nest actions in SpeedDial as SpeedDialButton children. The dial uses the shared Popper layer for placement and open state.
Setup
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger } from '.';
</script> Default
Hover (default trigger) the trigger to reveal actions.
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger } from '.';
</script>
<SpeedDialTrigger />
<SpeedDial>
<SpeedDialButton name="Share">…</SpeedDialButton>
<SpeedDialButton name="Print">…</SpeedDialButton>
<SpeedDialButton name="Save">…</SpeedDialButton>
</SpeedDial> Click trigger
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger } from '.';
</script>
<SpeedDialTrigger />
<SpeedDial trigger="click" placement="left" tooltip="top">
<SpeedDialButton name="Share">…</SpeedDialButton>
<SpeedDialButton name="Print">…</SpeedDialButton>
</SpeedDial> Gradient trigger
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger } from '.';
</script>
<SpeedDialTrigger gradient color="purple" />
<SpeedDial>
<SpeedDialButton name="New" color="purple">…</SpeedDialButton>
</SpeedDial> Text outside / no tooltip
Context from SpeedDial (pill, tooltip, textOutside) flows into buttons. Override per button when needed.
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger } from '.';
</script>
<SpeedDialTrigger pill />
<SpeedDial textOutside tooltip="none" placement="top">
<SpeedDialButton name="Share" textOutside tooltip="none">…</SpeedDialButton>
<SpeedDialButton name="Print" textOutside tooltip="none">…</SpeedDialButton>
</SpeedDial> Controlled open
<script lang="ts">
import { SpeedDial, SpeedDialButton, SpeedDialTrigger, Button } from '.';
let isOpen = $state(false);
</script>
<Button onclick={() => (isOpen = !isOpen)}>Toggle dial</Button>
<SpeedDialTrigger />
<SpeedDial bind:isOpen trigger="click">
<SpeedDialButton name="Share">…</SpeedDialButton>
</SpeedDial> Props
SpeedDial
| Prop | Type | Default | Description |
|---|---|---|---|
children | Snippet | — | SpeedDialButton actions (required) |
button | Snippet | — | Optional custom trigger slot (Popper) |
placement | Floating UI Placement | 'top' | Menu placement relative to trigger |
trigger | 'hover' | 'click' | 'hover' | Open interaction |
tooltip | Placement | 'none' | 'left' | Default tooltip side for buttons |
pill | boolean | true | Round buttons (context) |
textOutside | boolean | false | Label outside the button |
isOpen | boolean | false | Bindable open state |
popperClass / classes.popper | ClassValue | — | Popper panel classes |
ontoggle / onbeforetoggle | event handlers | — | Popper toggle lifecycle |
...rest | PopperProps | — | Offset, strategy, transition, etc. |
SpeedDialTrigger
| Prop | Type | Default | Description |
|---|---|---|---|
gradient | boolean | false | Use gradient button styling |
color | button / gradient color | — | Depends on gradient |
pill | boolean | — | Pill shape |
name | string | — | Accessible name |
icon | Snippet | — | Custom trigger icon |
children | any | — | Optional trigger content |
class | string | — | Extra classes |
SpeedDialButton
| Prop | Type | Default | Description |
|---|---|---|---|
name | string | — | Tooltip / label text |
tooltip | Placement | 'none' | from context | Per-button tooltip |
pill | boolean | from context | Round shape |
textOutside | boolean | from context | External label |
textClass | ClassValue | — | Label classes |
...rest | ButtonProps | — | color, onclick, href, icons, etc. |