YYonda UI Docs

Stepper

Multi-step progress indicator for checkout, booking, and onboarding flows. Booking.com / Klook pattern. Horizontal (default) for wide surfaces; vertical for narrow columns. Completed steps show a checkmark and are click-back navigable by default; upcoming steps are unclickable unless canNavigateForward is enabled.

  1. Your details

  2. Add extras

  3. Payment

  4. Confirmation

Vertical orientation

Pass orientation="vertical" for stacked layouts — better in narrow columns or long-form onboarding.

  1. Create account

    Email + password

  2. Profile

    Name, phone, preferences

  3. Verify email

    Check your inbox

  4. Welcome

    You're all set

Per-step description

Add description to any step for a muted-color secondary line under the label.

  1. Create account

    Email + password

  2. Profile

    Name, phone, preferences

  3. Verify email

    Check your inbox

  4. Welcome

    You're all set

Free navigation

By default users can navigate back (click completed steps) but not skip ahead (Booking.com pattern). Pass canNavigateForward to allow clicking upcoming steps — useful for wizards where every step is optional / preview-able.

  1. Your details

  2. Add extras

  3. Payment

  4. Confirmation

Usage notes

  • — Presentational and controlled: parent owns currentStep and swaps content based on it. Component only draws the indicator.
  • — Three states: completed (checkmark, brand-primary fill), current (brand-primary ring, number), upcoming (muted border + number).
  • — Completed steps render as <button> when onStepClick is provided; the current + upcoming steps are static <span> so they can't accidentally be tabbed to.
  • — Current step carries aria-current="step";every marker has a descriptive aria-label including state (completed / current / upcoming).
  • — Prerequisite for the BookingForm workstream (audit #32) — checkout will drive the steps.