Zum Inhalt springen
Dokumentation

Komponenten

Schritte (Stepper)

Stabil

Den 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 Badge oder StatusBadge; 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.

  1. ErfassungAbgeschlossenTicket aufnehmen
  2. PrüfungAktueller SchrittZuständigkeit klären
  3. BearbeitungAusstehend
  4. AbschlussAusstehend
Beispiel und Quelltext
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.

  1. VorbereitungAbgeschlossenÜbergabeliste prüfen
  2. MeldungAbgeschlossenOffene Punkte ansprechen
  3. BestätigungAktueller SchrittÜbergabe quittieren
Beispiel und Quelltext
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

  • Stepper rendert eine geordnete Liste ol; jeder Schritt ist ein li. Der aktuelle Schritt trägt aria-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-hidden ausgeblendet; 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

Props von Stepper
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
currentnumber–JaIndex of the active step; steps before it count as completed.
stepsStepperStep[]–JaSteps in display order.

Siehe auch