Zum Inhalt springen
Dokumentation

Komponenten

Zeitleiste (Timeline)

Stabil

Ereignisse in zeitlicher Reihenfolge – für Ticketverlauf und Schichtübergaben.

Eine Zeitleiste zeigt, was wann passiert ist: die Schritte eines Tickets, die Übergabe einer Schicht, die Änderungen an einem Dienstplan. Die Reihenfolge ist die Aussage – oben das Älteste, unten das Neueste.

Wann verwenden

  • Für einen Verlauf mit Zeitangabe, etwa „Ticket erstellt“, „Kommentar ergänzt“, „Ticket geschlossen“.
  • Wenn die Abfolge wichtiger ist als der einzelne Eintrag.
  • Für eine kurze Historie mit drei bis zehn Einträgen.
  • Wenn ein Symbol den Zustand eines Schritts verdeutlichen soll, etwa ein Haken für erledigt.

Wann nicht

  • Für gleichartige Datensätze, die verglichen werden, ist eine Tabelle besser.
  • Für eine einzelne Statusmeldung genügt ein Hinweis oder eine Kennzeichnung.
  • Für Aufgaben, die noch erledigt werden müssen, passt eine Checkliste oder ein Fortschritt besser als ein Verlauf.

Aufbau

Timeline ist die geordnete Liste, TimelineItem ein Eintrag mit time, title und optionalem Inhalt. Ein icon ersetzt den Standardpunkt; das Symbol wird für Screenreader ausgeblendet, weil der Titel die Aussage trägt.

  1. Ticket erstellt
    Rückfrage zur Bettenbelegung auf Station 3.
  2. Kommentar ergänzt
    Zimmer 102 ist ab 12:00 Uhr wieder frei.
  3. Ticket geschlossen
    Belegung im System korrigiert.
Beispiel und Quelltext
verlauf.tsx
import { CircleCheck, CircleDot, MessageSquare } from "lucide-react";
import { Timeline, TimelineItem } from "@neodin-eu/ui";

function Verlauf() {
  return (
    <Timeline aria-label="Verlauf von Ticket T-1042" className="w-full max-w-xl">
      <TimelineItem time="2026-11-18T07:45:00" icon={CircleDot} title="Ticket erstellt">
        Rückfrage zur Bettenbelegung auf Station 3.
      </TimelineItem>
      <TimelineItem time="2026-11-18T09:10:00" icon={MessageSquare} title="Kommentar ergänzt">
        Zimmer 102 ist ab 12:00 Uhr wieder frei.
      </TimelineItem>
      <TimelineItem time="2026-11-18T14:30:00" icon={CircleCheck} title="Ticket geschlossen">
        Belegung im System korrigiert.
      </TimelineItem>
    </Timeline>
  );
}

Zeitangaben

time nimmt ein Date oder einen ISO-Text entgegen. Beides wird mit Intl.DateTimeFormat in der Sprache der Anwendung formatiert und in einem time-Element mit maschinenlesbarem dateTime ausgegeben. Ein Text, der sich nicht als Datum lesen lässt, bleibt unverändert stehen – etwa „gestern“.

  1. Übergabe begonnen
    Nachtdienst übergibt an den Frühdienst.
  2. Dienstplan geprüft
    Zwei offene Dienste für den Spätdienst gemeldet.
  3. Übergabe abgeschlossen
    Alle Betten und offenen Aufgaben sind dokumentiert.
Beispiel und Quelltext
uebergabe.tsx
import { Timeline, TimelineItem } from "@neodin-eu/ui";

function Uebergabe() {
  return (
    <Timeline aria-label="Schichtübergabe Station 3" className="w-full max-w-xl">
      <TimelineItem time="06:45" title="Übergabe begonnen">
        Nachtdienst übergibt an den Frühdienst.
      </TimelineItem>
      <TimelineItem time="07:00" title="Dienstplan geprüft">
        Zwei offene Dienste für den Spätdienst gemeldet.
      </TimelineItem>
      <TimelineItem time="07:15" title="Übergabe abgeschlossen">
        Alle Betten und offenen Aufgaben sind dokumentiert.
      </TimelineItem>
    </Timeline>
  );
}

Barrierefreiheit

  • Die Zeitleiste ist eine geordnete Liste (ol) mit Einträgen (li). Im Komponententest werden getByRole("list", …) und alle Listeneinträge geprüft.
  • Ein aria-label benennt den Verlauf, etwa „Verlauf von Ticket T-1042“.
  • Die Zeit steht in einem time-Element. Bei einem gültigen Datum trägt es ein ISO-dateTime, sonst bleibt es ohne Attribut. Beides ist im Komponententest abgesichert.
  • Das Symbol ist aria-hidden; Titel und Zeit tragen die Information.
  • Die Zeitleiste ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Timeline
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
Props von TimelineItem
PropTypStandardPflichtBeschreibung
childrenReactNode–NeinBody content below the heading and time.
classNamestring–Nein–
iconLucideIcon–NeinMarker icon; defaults to a filled circle.
timestring | Date–JaA `Date` or an ISO date string; formatted with `Intl.DateTimeFormat`.
titleReactNode–JaHeading of the timeline entry.

Siehe auch