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

<mth-checkout-steps>

@methane-ui/commerce~7.9 KB brotli (kit + Lit)~2.0 KB marginal

Multi-step checkout progress coordinator supporting linear completion gating, vertical/horizontal layouts, and RTL roving focus.

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-checkout-steps> (@methane-ui/commerce)
Ready · interact with <mth-checkout-steps>, or toggle Theme, Direction (LTR/RTL), or props above.

Multi-Framework Playground & Snippets

<script type="module" src="@methane-ui/commerce/checkout-steps"></script>
<mth-checkout-steps orientation="horizontal" linear></mth-checkout-steps>

Properties & Attributes

PropertyAttributeTypeDefaultDescription
steps—ReadonlyArray<unknown>—Ordered list of CheckoutStep items (shipping, delivery, payment, review).
activeStepactive-stepstring""Currently active step ID.
orientationorientation'horizontal' | 'vertical'"horizontal"Step list orientation: horizontal or vertical.
linearlinearbooleantrueWhen true, prevents activating steps ahead of incomplete preceding steps.
labellabelstring""Accessible navigation label overriding localized default.

Events

EventDetail TypeDescription
mth-step-change{ stepId: string; index: number }Emitted event mth-step-change.
mth-step-complete{ stepId: string }Emitted event mth-step-complete.

APG Keyboard Matrix

KeyDirectionWhenExpected Behavior
ArrowRightbothhorizontalMove focus to next step (previous in RTL).
ArrowLeftbothhorizontalMove focus to previous step (next in RTL).
ArrowDownbothverticalMove focus to next step in vertical orientation.
ArrowUpbothverticalMove focus to previous step in vertical orientation.
HomebothfocusedFocus first step.
EndbothfocusedFocus last step.
Enterbothstep-button focusedActivate unlocked step.

Accessibility Checklist

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