Zum Inhalt springen
Dokumentation

Komponenten

Kennzeichnung (Badge)

Stabil

Kurze 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.

NeuIn PrüfungEntwurfÜberfällig
Beispiel und Quelltext
varianten.tsx
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.

Zur Doku-Übersicht

Beispiel und Quelltext
im-text.tsx
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.

Neu
Code
import { Badge } from "@neodin-eu/ui";

<Badge>Neu</Badge>

Barrierefreiheit

  • Badge rendert ein span. 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 asChild bekommt das Kindelement seine eigene Semantik. Ein Link in einer Kennzeichnung ist also fokussierbar und mit Enter erreichbar – die Kennzeichnung selbst bringt keine Tastaturbedienung mit.

Props

Props von Badge
PropTypStandardPflichtBeschreibung
asChildbooleanfalseNeinRender the child element instead of a `<span>` (Radix Slot).
classNamestring–Nein–
variant"default" | "secondary" | "destructive" | "outline" | null–NeinVisual style of the badge; defaults to `"default"`.

Siehe auch