Methane@methane-ui/*
CSS LayoutsComponentsSkillsTheme BuilderGitHub
← All Components

<mth-speed-dial>

@methane-ui/ui~11.2 KB brotli (cold + Lit)~3.8 KB marginal

Floating speed-dial FAB revealing contextual secondary actions with roving focus and Escape dismissal.

When NOT to use: Use a lightweight @methane-ui/css layout class instead of a custom element when static CSS suffices.

Live Interactive Preview

Interactive StageLive Custom Element · <mth-speed-dial> (@methane-ui/ui)
Ready · interact with <mth-speed-dial>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/speed-dial"></script>
<mth-speed-dial direction="up" variant="primary">Example</mth-speed-dial>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
openopenbooleanfalseWhether the speed-dial action tray is expanded.
directiondirection'up' | 'down' | 'start' | 'end'"up"Expansion direction relative to the trigger (up, down, start, or end).
labellabelstring""Accessible aria-label for the main trigger button.
disableddisabledbooleanfalseDisables trigger interaction.
variantvariant'primary' | 'surface' | 'secondary'"primary"Trigger button style (primary, surface, or secondary).
sizesize'sm' | 'md' | 'lg'"md"Trigger dimension scale (sm, md, or lg).

Events

EventDetail TypeDescription
mth-open{ open: true }Cancelable event fired before expanding actions.
mth-after-open{ open: true }Fired after actions finish expanding.
mth-close{ reason: string }Fired when actions close.
mth-after-close{ reason: string }Fired after close completes and focus returns to the trigger.
mth-select{ value: string; label: string }Fired when a speed-dial action item is activated.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
EnterbothTrigger button is focusedToggles speed-dial actions menu open/closed
ArrowUpbothActions menu is open in vertical directionMoves focus between speed-dial action items
ArrowDownbothActions menu is open in vertical directionMoves focus between speed-dial action items
EscapebothActions menu is openCloses speed-dial and restores focus to trigger

Accessibility Checklist

CategoryRequirementVerified By
ariaAll aria-* IDREFs resolve within the same DOM root (ADR-003).scanSameRootAria
focusdelegatesFocus: true with zero host internals.role (ADR-014).lint-plugin & spec-compiler
contrastRenders legible borders, focus outlines, and selection indicators under forced-colors: active.Playwright forced-colors matrix
keyboardImplements all 4 APG keyboard transitions across LTR/RTL.mth-speed-dial.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(open), :state(disabled).Conformance suite
i18nRoutes 2 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test