Komponenten
Statusabzeichen (StatusBadge)
StabilDer 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.
| Ticket | Thema | Status |
|---|---|---|
| T-1042 | Dienstplan Dezember | in Arbeit |
| T-1043 | Bettenbelegung Station 3 | wartet auf Kund:in |
| T-1044 | Zugang zur Notaufnahme | gelöst |
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.
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_LABELund ein SVG gefunden. - Das Symbol ist
aria-hidden; der zugängliche Text ist die Beschriftung allein. Farbe ist damit nicht der einzige Hinweis. statusist 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | Additional classes for the badge. |
| status | enum | – | Ja | Ticket status shown as icon and label. |