Skip to content

Stepper

Überblick

mmm-stepper visualisiert mehrstufige Prozesse und kombiniert Schrittstatus, Auswahl und optional Substeps in einem Overlay.

Subkomponenten

  • mmm-stepper: Container der Schrittlogik
  • mmm-step: einzelner Schritt

Schrittzustände

Auf mmm-step stehen folgende States zur Verfügung:

  • default
  • completed
  • error

Substeps unterstützen:

  • default
  • completed
  • current
  • error

Inputs

mmm-stepper

InputTypBeschreibung
selectedIndexnumberAktuell aktiver Schritt

mmm-step

InputTypBeschreibung
labelstringSichtbares Schritlabel
descriptionstring | nullZusatztext für Overlay und Kontext
state`‘default''completed'
substepsMmmSubstep[]Optionale Unterpunkte

Outputs

OutputTypBeschreibung
selectedIndexChangeEventEmitter<number>Änderung des aktiven Schritts
selectionChangeEventEmitter<{ selectedIndex: number; previouslySelectedIndex: number }>Vollständige Selektionsänderung

SCSS-Variablen

Wichtige Variablen:

  • --mmm-stepper-gap
  • --mmm-stepper-header-padding-bottom
  • --mmm-stepper-line-height
  • --mmm-stepper-line-radius
  • --mmm-stepper-line-margin-inline
  • --mmm-stepper-step-max-width: maximale Breite eines Schritts (s: 100%, m: 139,29px, ab l: 194,71px)
  • --mmm-stepper-target-size: Klick-, Hover- und Fokusfläche eines Schritts, zugleich Größe des aktuellen und fehlerhaften Schritts (s: 34px, ab m: 44px)
  • --mmm-stepper-circle-size: Kreis der übrigen Schritte (s: 24px, ab m: 32px)
  • --mmm-stepper-circle-inner-size: Füllung des aktuellen Schritts
  • --mmm-stepper-circle-radius
  • --mmm-stepper-circle-border-width / --mmm-stepper-circle-border-width-strong
  • --mmm-stepper-focus-ring-gap / --mmm-stepper-focus-ring-width
  • --mmm-stepper-substeps-button-size
  • --mmm-stepper-substeps-padding-inline-end
  • --mmm-stepper-overlay-width
  • --mmm-stepper-overlay-item-radius
  • --mmm-stepper-overlay-dot-size

Hinweise

  • Schritte werden über Projektion als mmm-step eingebunden.
  • Die Komponente ist per Tastatur bedienbar.
  • Substeps werden in einem Overlay dargestellt und können für feinere Prozessschritte genutzt werden.
  • Darstellung: Offene Schritte sind grau, abgeschlossene blau mit Haken. Der aktuelle Schritt ist größer und gefüllt, ein fehlerhafter Schritt ist größer, hellrot gefüllt und zeigt ein Warnsymbol am Label (aktuell und fehlerhaft: rot gefüllt). Hover, Pressed und Fokus liegen auf der Zielfläche um den Kreis, mit Substeps als Pille um Kreis und Chevron.
  • Responsive: Unter Breakpoint m nimmt der Stepper die volle Breite ein und zeigt nur die Kreise ohne Labels. Ab m werden die Labels angezeigt, jeder Schritt ist maximal 139,29px (ab l 194,71px) breit, der Stepper ist zentriert. Lange Labels brechen um.
  • in Figma unter Progress Tracker zu finden

Beispiel

<mmm-stepper [(selectedIndex)]="stepIndex">
  <mmm-step label="Start">Inhalt Schritt 1</mmm-step>
  <mmm-step label="Prüfen" state="completed">Inhalt Schritt 2</mmm-step>
  <mmm-step label="Fehler" state="error">Inhalt Schritt 3 </mmm-step>
  <mmm-step
    label="Freigabe"
    [substeps]="[
      { label: 'Dokumente', state: 'completed' },
      { label: 'Prüfung', state: 'current' }
    ]"
  >
    Inhalt Schritt 4
  </mmm-step>
</mmm-stepper>
Start
Prüfen
warnschild_24Fehler
Freigabe
Inhalt Schritt 1