fma-ds

Stepper

Multi-step navigation, horizontal or vertical, built on react-aria Tabs.

Navigationthird-partyMITChangelogRegistry JSON

Overview

  • Keyboard: arrow keys, Home and End move between steps; Enter or Space selects one (manual activation).
  • Value: value/defaultValue/onValueChange hold the current step.
  • `StepperItem`: a tab whose data-state is completed (before the current step, or isCompleted), active or inactive. isDisabled skips it and isLoading shows the loading indicator.
  • `indicators`: swaps an indicator's content per state.
  • `StepperContent`: panels with the current step's content.

Installation

  1. 1

    Register the @fma-ds namespace in components.json (once)

    components.json
    {  "registries": {    "@fma-ds": "https://ds.fmartinsandre.dev.br/r/{name}.json"  }}
  2. 2

    Add the item

    pnpm dlx shadcn@latest add @fma-ds/stepper

    Files land in components/fma-ds/stepper.tsx; npm and registry dependencies are installed along with them.

Dependencies

npm
cn@^0.5.0react-aria-components@^1.22.1
Registry
None