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

<mth-form-wizard>

@methane-ui/ui~9.0 KB brotli (cold + Lit)~2.6 KB marginal

Multi-step form wizard coordinating Light-DOM step panels via SelectionController and SlotCollectionController with per-step validation gates.

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-form-wizard> (@methane-ui/ui)
Enable automatic OKLCH dark mode
Ready to provision workspace with Declarative Shadow DOM.
Ready · interact with <mth-form-wizard>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/ui/form-wizard"></script>
<mth-form-wizard active-step="0" linear></mth-form-wizard>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
activeStepactive-stepnumber0Zero-based index of the currently active step.
stepstepstring""Identifier (data-step or id) of the currently selected step.
labellabelstring""Accessible region label for the wizard.
linearlinearbooleantrueWhen true, prevents skipping ahead past steps that have not been reached.
validateOnNextvalidate-on-nextbooleantrueRuns constraint validity checks on active step controls before advancing.
backLabelback-labelstring""Custom Back button label.
nextLabelnext-labelstring""Custom Next button label.
submitLabelsubmit-labelstring""Custom Finish button label on the final step.

Events

EventDetail TypeDescription
mth-step-change{ index: number; previousIndex: number; step: string }Cancelable event emitted before transitioning between steps.
mth-complete{ steps: number }Emitted when the final step passes validation and completes.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
Enterbothnext/submit button focusedvalidates current step and advances or completes wizard

Accessibility Checklist

CategoryRequirementVerified By
ariaAll aria-* IDREFs resolve within the same DOM root (ADR-003).scanSameRootAria
focusFocus ownership matches focusModel="none".lint-plugin & spec-compiler
contrastRenders legible borders, focus outlines, and selection indicators under forced-colors: active.Playwright forced-colors matrix
keyboardImplements all 1 APG keyboard transitions across LTR/RTL.mth-form-wizard.spec.test.ts
statesExposes ElementInternals CustomStateSet flags: :state(completed).Conformance suite
i18nRoutes 8 UI/ARIA strings through @methane-ui/core i18n catalog.Locale context test