Zum Inhalt springen
Dokumentation

Komponenten

Statusabzeichen (StatusBadge)

Stabil

Der Zustand eines Tickets in einem Wort – mit Symbol und Text, nie nur mit Farbe.

Ein Statusabzeichen zeigt den Zustand eines Tickets in einem Wort: offen, in Arbeit, wartet auf Kund:in, gelöst, geschlossen. Es steht in Listen und Detailansichten an derselben Stelle, damit du den Zustand ohne Lesen der ganzen Zeile erkennst.

Wann verwenden

  • In Ticketlisten und -details, wenn der Zustand auf einen Blick sichtbar sein soll.
  • In Filtern und Übersichten, damit alle denselben Wortlaut verwenden.
  • Wenn sich der Zustand im Verlauf ändert und die aktuelle Stufe wichtig ist.
  • Wenn Farbe allein nicht reicht, weil die Ansicht auch ohne Farbe lesbar bleiben muss.

Wann nicht

  • Für freie Kategorien und Schlagwörter ist eine Kennzeichnung (Badge) besser; sie kennt keine festen Zustände.
  • Für die Dringlichkeit gibt es ein eigenes Prioritätsabzeichen (PriorityBadge).
  • Für einen Anteil oder eine Reihenfolge von Schritten passen Fortschritt (Progress) oder Schrittfolge (Stepper).
  • Wenn der Zustand erklärt werden muss, gehört ein Satz daneben; ein einzelnes Wort reicht dann nicht.

In einer Liste

Das Abzeichen steht in einer eigenen Spalte oder direkt hinter dem Titel. Es richtet sich an der Textgröße aus und bleibt einzeilig. Im Beispiel trägt jedes Ticket genau einen Zustand.

TicketThemaStatus
T-1042Dienstplan Dezemberin Arbeit
T-1043Bettenbelegung Station 3wartet auf Kund:in
T-1044Zugang zur Notaufnahmegelöst
Beispiel und Quelltext
ticketliste.tsx
import {
  StatusBadge,
  Table,
  TableBody,
  TableCell,
  TableHead,
  TableHeader,
  TableRow,
} from "@neodin-eu/ui";

function Ticketliste() {
  return (
    <div className="w-full max-w-xl rounded-xl border border-border bg-background">
      <Table>
        <TableHeader>
          <TableRow>
            <TableHead>Ticket</TableHead>
            <TableHead>Thema</TableHead>
            <TableHead>Status</TableHead>
          </TableRow>
        </TableHeader>
        <TableBody>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1042</TableCell>
            <TableCell>Dienstplan Dezember</TableCell>
            <TableCell>
              <StatusBadge status="in_progress" />
            </TableCell>
          </TableRow>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1043</TableCell>
            <TableCell>Bettenbelegung Station 3</TableCell>
            <TableCell>
              <StatusBadge status="waiting_customer" />
            </TableCell>
          </TableRow>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1044</TableCell>
            <TableCell>Zugang zur Notaufnahme</TableCell>
            <TableCell>
              <StatusBadge status="solved" />
            </TableCell>
          </TableRow>
        </TableBody>
      </Table>
    </div>
  );
}

Alle Zustände

status ist auf fünf Werte festgelegt: open, in_progress, waiting_customer, solved und closed. Die deutschen Beschriftungen kommen aus STATUS_LABEL; jede Stufe hat ein eigenes Symbol und eine ruhige Farbe. Die Bedeutung steht hier zusätzlich als Text daneben.

  • offenNoch niemand hat das Ticket übernommen.
  • in ArbeitDas Ticket ist in Bearbeitung.
  • wartet auf Kund:inDie Rückmeldung der anfragenden Stelle fehlt.
  • gelöstDie Aufgabe ist erledigt, das Ticket bleibt auffindbar.
  • geschlossenDas Ticket ist abgeschlossen und archiviert.
Beispiel und Quelltext
alle.tsx
import { StatusBadge, type TicketStatus } from "@neodin-eu/ui";

const ZUSTAENDE: { status: TicketStatus; bedeutung: string }[] = [
  { status: "open", bedeutung: "Noch niemand hat das Ticket übernommen." },
  { status: "in_progress", bedeutung: "Das Ticket ist in Bearbeitung." },
  { status: "waiting_customer", bedeutung: "Die Rückmeldung der anfragenden Stelle fehlt." },
  { status: "solved", bedeutung: "Die Aufgabe ist erledigt, das Ticket bleibt auffindbar." },
  { status: "closed", bedeutung: "Das Ticket ist abgeschlossen und archiviert." },
];

function Alle() {
  return (
    <ul className="flex w-full max-w-xl flex-col gap-2">
      {ZUSTAENDE.map((eintrag) => (
        <li key={eintrag.status} className="flex items-center gap-3 text-sm">
          <StatusBadge status={eintrag.status} className="min-w-28" />
          <span className="text-muted-foreground">{eintrag.bedeutung}</span>
        </li>
      ))}
    </ul>
  );
}

Barrierefreiheit

  • Jedes Abzeichen verbindet Symbol und deutsches Wort. Im Komponententest werden für alle fünf Zustände die Beschriftung aus STATUS_LABEL und ein SVG gefunden.
  • Das Symbol ist aria-hidden; der zugängliche Text ist die Beschriftung allein. Farbe ist damit nicht der einzige Hinweis.
  • status ist Pflicht und auf die fünf Werte beschränkt. Ein unbekannter Wert fällt schon beim Typecheck auf, nicht erst in der Ansicht.
  • Das Abzeichen ist im Komponententest in hell und dunkel frei von axe-Verstößen.
  • In der Ticketliste steht der Zustand in einer Tabellenspalte mit Überschrift; der Zusammenhang ist damit auch für Screenreader klar.

Props

Props von StatusBadge
PropTypStandardPflichtBeschreibung
classNamestring–NeinAdditional classes for the badge.
statusenum–JaTicket status shown as icon and label.

Siehe auch