Skip to content

SusStepper

SusStepper

Multi-step progress header — titles, icons, active index.

Package

SusKit · Atoms (commercial)

Open in Playground

SusKit · Atoms

Props

NameTypeDefault
ModelProp<int>0v-model
DirectionProp<string>"horizontal"v-model
VariantProp<string>"default"v-model
NonLinearProp<bool>falsev-model
ShowStepNumberProp<bool>truev-model

Slots

Name
(default)

Events

NameFieldPayload
StepChangedOnStepChangedint

Style hooks

USS class contract — override appearance without touching C#. States toggle via these classes:

  • keyboard-focus
  • sus-stepper
  • sus-stepper__content
  • sus-stepper__divider
  • sus-stepper__divider--active
  • sus-stepper__headers
  • sus-stepper__icon
  • sus-stepper__indicator
  • sus-stepper__info
  • sus-stepper__number
  • sus-stepper__step
  • sus-stepper__step--active
  • sus-stepper__step--complete
  • sus-stepper__step--error
  • sus-stepper__subtitle
  • sus-stepper__title
  • sus-stepper--alt-labels
  • sus-stepper--non-linear
  • sus-stepper--vertical
  • unity-label
  • unity-text-element

Usage

Items are set in code (List<StepItem>).

csharp
var stepper = new SusStepper();
stepper.Items.Value = new List<SusStepper.StepItem>
{
    new() { Title = "Account", Subtitle = "Credentials", Icon = "user" },
    new() { Title = "Squad", Subtitle = "Roster", Icon = "users" },
    new() { Title = "Ready", Subtitle = "Confirm", Icon = "check" },
};
stepper.Model.Value = 0;
stepper.Direction.Value = "horizontal";
stepper.ShowStepNumber.Value = true;
stepper.OnStepChanged += index => { /* … */ };
PropRole
ItemsList<StepItem>Title, Subtitle, Icon, Complete, Error
ModelActive step index (0-based)
Directionhorizontal | vertical
NonLinearAllow jumping to any step
ShowStepNumberNumber badge in the header

Notes

  • Default slot holds the body for the active step.
  • Mark past steps with Complete / Error on each StepItem.