Stepper
Uso
Indica progresso em fluxos sequenciais (checkout, cadastro). Stepper + StepperList + StepperItem; value 0-based; passos concluídos, atual e pendentes.
Quando usar
- Padrão navigationMode sequential — avance com botões no formulário.
- navigationMode free + onValueChange para clicar em 1, 2, 3 e saltar etapas.
- orientation horizontal (padrão) ou vertical.
- title e description opcional em cada StepperItem.
Evite quando
- Não use para navegação livre entre abas — Tabs.
- Evite dezenas de passos — divida o fluxo.
Instalação
Com o namespace @youxgroup configurado em components.json (veja Instalação).
pnpm dlx shadcn@latest add @youxgroup/stepperExemplos
Variações comuns de uso.
Horizontal
Vertical
Com botões (padrão)
Padrão: só os botões mudam a etapa (passos não são clicáveis).
Clicável nos passos
Clique no número de cada passo ou use Anterior / Próximo.