Komponenten
Schritte (Stepper)
StabilDen Fortschritt durch einen Ablauf zeigen – erledigt, aktuell, ausstehend.
Schritte zeigen, wo in einem Ablauf du gerade stehst: Ticket erfasst, geprüft, in Bearbeitung, abgeschlossen. Erledigte Schritte bleiben sichtbar, der aktuelle ist hervorgehoben, die folgenden stehen noch aus.
Wann verwenden
- Für einen mehrstufigen Ablauf mit fester Reihenfolge, etwa die Aufnahme eines Tickets oder die Übergabe einer Schicht.
- Wenn du den Fortschritt ohne Interaktion anzeigen willst; die Schritte selbst sind keine Knöpfe.
- Wenn vor allem der aktuelle Schritt zählt und die Umgebung nur zur Orientierung dient.
Wann nicht
- Für gleichrangige Ansichten sind Reiter richtig. Schritte haben eine Richtung, Reiter nicht.
- Für einen einzelnen Vorgang mit zwei Zuständen genügt ein
BadgeoderStatusBadge; eine Schrittleiste mit zwei Einträgen wirkt überladen. - Für eine reine Zahl, etwa „3 von 5“, ist ein
Progress-Balken direkter. Der Stepper erzählt die Namen der Schritte, nicht nur den Anteil.
Aufbau
Stepper bekommt eine Liste steps aus { id, label, description? } und den
Index current. Alle Schritte vor current gelten als erledigt, der Schritt
bei current als aktuell, alle danach als ausstehend. Eine Beschreibung ist
optional und erklärt den Schritt in einem kurzen Satz.
- ErfassungAbgeschlossenTicket aufnehmen
- PrüfungAktueller SchrittZuständigkeit klären
- BearbeitungAusstehend
- AbschlussAusstehend
ticket.tsx
import { Stepper } from "@neodin-eu/ui";
const schritte = [
{ id: "erfassung", label: "Erfassung", description: "Ticket aufnehmen" },
{ id: "pruefung", label: "Prüfung", description: "Zuständigkeit klären" },
{ id: "bearbeitung", label: "Bearbeitung" },
{ id: "abschluss", label: "Abschluss" },
];
function Ticket() {
return (
<Stepper
steps={schritte}
current={1}
aria-label="Fortschritt Ticket"
className="w-full max-w-2xl"
/>
);
}Mit Beschreibungen
Beschreibungen helfen, wenn die Bezeichnung allein nicht sagt, was zu tun ist.
Auf schmalen Bildschirmen stehen die Schritte untereinander, ab sm in einer
Reihe.
- VorbereitungAbgeschlossenÜbergabeliste prüfen
- MeldungAbgeschlossenOffene Punkte ansprechen
- BestätigungAktueller SchrittÜbergabe quittieren
schicht.tsx
import { Stepper } from "@neodin-eu/ui";
const schritte = [
{ id: "vorbereitung", label: "Vorbereitung", description: "Übergabeliste prüfen" },
{ id: "meldung", label: "Meldung", description: "Offene Punkte ansprechen" },
{ id: "bestaetigung", label: "Bestätigung", description: "Übergabe quittieren" },
];
function Schicht() {
return (
<Stepper
steps={schritte}
current={2}
aria-label="Übergabe Schicht"
className="w-full max-w-2xl"
/>
);
}Barrierefreiheit
Stepperrendert eine geordnete Listeol; jeder Schritt ist einli. Der aktuelle Schritt trägtaria-current="step", die übrigen nicht. Das ist im Komponententest abgesichert.- Der Zustand hängt nicht an der Farbe: Jeder Schritt trägt zusätzlich einen nur für Screenreader sichtbaren Text – „Abgeschlossen“, „Aktueller Schritt“ oder „Ausstehend“. Der Komponententest prüft alle drei.
- Die Symbole sind mit
aria-hiddenausgeblendet; vorgelesen wird die Bezeichnung, nicht das Icon. - Der Stepper ist nicht interaktiv und hat keinen eigenen Tastaturfokus. Er ergänzt eine Ansicht, die bereits bedienbar ist.
- Der Komponententest prüft hell und dunkel ohne axe-Verstöße.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| current | number | – | Ja | Index of the active step; steps before it count as completed. |
| steps | StepperStep[] | – | Ja | Steps in display order. |