R
fn

useStepper

v0.0.15testeddemo

A composable for building wizards/steppers over a list or record of steps

Examples

ts
const { current, goToNext, isLast } = useStepper(['first', 'second', 'last']);
ts
const { current, stepNames, goTo } = useStepper({
  account: { title: 'Account' },
  billing: { title: 'Billing' },
});

Demo

Loading demo…

Signatures

ts
export function useStepper<T extends string | number>(
  steps: MaybeRef<T[]>,
  initialStep?: T,
): UseStepperReturn<T, T[], T>;
ts
export function useStepper<T extends Record<string, any>>(
  steps: MaybeRef<T>,
  initialStep?: keyof T,
): UseStepperReturn<Exclude<keyof T, symbol>, T, T[keyof T]>;

Parameters

ParameterTypeDescription
stepsanyThe list of steps, or a record keyed by step name
initialStep?anyThe step to start on (defaults to the first step)

Returns

UseStepperReturn<any, any, any>The stepper state and navigation helpers