Stepper
Beta notice: This page is being built.Edit on GitHub(opens in new tab)
Displays progress by default. Set variant to wizard to show one persistent Step panel at a time with Next/Back navigation. Inside Form, Next validates the current panel and shared fields; only an explicit submit Button in the last Step submits all fields. Outside Form, wizard navigation works independently without submitting data. Set height to pin progress above centered, scrollable panels.
This is a LongLink-specific component.
longlink docs component "Stepper"
Example
- Detailscompleted
- Review
- Complete
- Details
- Review
- Complete
Properties
| Stepper - Properties |
|---|
variant Defaults to progress. Wizard mode owns persistent panels and Next/Back navigation."progress" | "wizard" |
height Bounds a wizard, pinning progress above its scrollable panels.number | string |
next Runs intermediate work after validation. Returning false prevents advancement.(step: number) => { label: string; action: () => void | boolean | Promise<void | boolean> } | undefined |
onCancel Adds a Cancel action to wizard navigation.() => void |
backVariant Wizard Back button appearance; defaults to secondary."secondary" | "ghost" |
children Step elements to render in the stepper.ReactNode |
activeStep Zero-based active index. Wizard mode manages selection internally when omitted.number |
orientation Layout direction of the stepper."horizontal" | "vertical" |
onStepClick Enables progress step activation, or receives wizard selection changes.(index: number) => void |
| Step - Properties |
|---|
step Optional progress index; defaults to child order. Wizards always use child order.number |
label Visible label identifying the step.string |
description Supporting text displayed below the step label.string |
children Persistent panel content in wizard mode; inline content in progress mode.ReactNode |