Stepper
Überblick
mmm-stepper visualisiert mehrstufige Prozesse und kombiniert Schrittstatus, Auswahl und optional Substeps in einem Overlay.
Subkomponenten
mmm-stepper: Container der Schrittlogikmmm-step: einzelner Schritt
Schrittzustände
Auf mmm-step stehen folgende States zur Verfügung:
defaultcompletederror
Substeps unterstützen:
defaultcompletedcurrenterror
Inputs
mmm-stepper
| Input | Typ | Beschreibung |
|---|---|---|
selectedIndex | number | Aktuell aktiver Schritt |
mmm-step
| Input | Typ | Beschreibung |
|---|---|---|
label | string | Sichtbares Schritlabel |
description | string | null | Zusatztext für Overlay und Kontext |
state | `‘default' | 'completed' |
substeps | MmmSubstep[] | Optionale Unterpunkte |
Outputs
| Output | Typ | Beschreibung |
|---|---|---|
selectedIndexChange | EventEmitter<number> | Änderung des aktiven Schritts |
selectionChange | EventEmitter<{ 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-stepeingebunden. - 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
mnimmt der Stepper die volle Breite ein und zeigt nur die Kreise ohne Labels. Abmwerden die Labels angezeigt, jeder Schritt ist maximal 139,29px (abl194,71px) breit, der Stepper ist zentriert. Lange Labels brechen um. - in Figma unter
Progress Trackerzu 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
Freigabe
Inhalt Schritt 1