Komponenten
Kennzeichnung (Badge)
StabilKurze Zustände und Kategorien direkt am Eintrag – vier Varianten mit klarer Bedeutung.
Eine Kennzeichnung ordnet eine Zeile oder einen Datensatz ein: offen, belegt, überfällig. Sie ist reiner Text und löst selbst keine Aktion aus.
Wann verwenden
- Für den Zustand eines Eintrags in einer Liste oder Tabelle, etwa „Offen“, „In Prüfung“ oder „Überfällig“ beim Ticket.
- Für eine kurze Kategorie neben der Überschrift, zum Beispiel „Station 3“ neben der Bettenbelegung.
- Für Zusatzinformationen in einer Karte, wenn ein ganzer Satz zu viel wäre.
Wann nicht
- Für Aktionen ist eine Schaltfläche die richtige Wahl. Eine Kennzeichnung trägt den Zustand, nicht den Aufruf zur Aktion.
- Für lange Sätze oder Erklärungen: Der Text einer Kennzeichnung bleibt kurz.
Ausführliche Hinweise gehören in den Fließtext oder in einen
Alert. - Für Werte, die sich laufend ändern, ist eine Kennzahl passender. Eine Kennzeichnung wird nicht zur Anzeige von Messwerten verwendet.
Varianten
default trägt die wichtigste Kennzeichnung, secondary bleibt ruhig für
Nebeninformationen, outline grenzt sich nur über den Rahmen ab und
destructive markiert eine überfällige oder stornierte Sache. Die Bedeutung
steht immer im Text – die Farbe allein reicht nicht.
import { Badge } from "@neodin-eu/ui";
function Varianten() {
return (
<div className="flex flex-wrap items-center gap-3">
<Badge>Neu</Badge>
<Badge variant="secondary">In Prüfung</Badge>
<Badge variant="outline">Entwurf</Badge>
<Badge variant="destructive">Überfällig</Badge>
</div>
);
}Im Text
Eine Kennzeichnung kann mitten im Satz stehen, wenn sie die Aussage ergänzt.
Mit asChild übernimmt sie die Semantik des Kindelements; ein Link bleibt so
ein echter Link.
Bett 12 ist seit dem Frühdienst belegt.
import Link from "next/link";
import { Badge } from "@neodin-eu/ui";
function ImText() {
return (
<div className="flex flex-col gap-3 text-sm">
<p>
Bett 12 ist seit dem Frühdienst <Badge variant="secondary">belegt</Badge>.
</p>
<p>
<Badge asChild variant="outline">
<Link href="/docs">Zur Doku-Übersicht</Link>
</Badge>
</p>
</div>
);
}Baukasten
Wähle eine Variante und ändere den Text. Darunter steht der passende JSX-Code zum Kopieren.
import { Badge } from "@neodin-eu/ui";
<Badge>Neu</Badge>Barrierefreiheit
Badgerendert einspan. Es gibt keine eigene Rolle und keinen Tastaturfokus; Screenreader lesen den Text im Fluss der Zeile.- Der Text trägt die Bedeutung. Statusfarben allein sind nicht ausreichend – das ist auch im Komponententest geprüft: dort rendert die Kennzeichnung ihren Inhalt und ist in hell und dunkel frei von axe-Verstößen.
- Mit
asChildbekommt das Kindelement seine eigene Semantik. Ein Link in einer Kennzeichnung ist also fokussierbar und mitEntererreichbar – die Kennzeichnung selbst bringt keine Tastaturbedienung mit.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | false | Nein | Render the child element instead of a `<span>` (Radix Slot). |
| className | string | – | Nein | – |
| variant | "default" | "secondary" | "destructive" | "outline" | null | – | Nein | Visual style of the badge; defaults to `"default"`. |