Zum Inhalt springen
Dokumentation

Komponenten

Priorität (PriorityBadge)

Stabil

Die Dringlichkeit eines Tickets in einem Wort – mit Symbol, Text und ruhiger Farbe.

Ein Prioritätsabzeichen zeigt, wie dringend ein Ticket ist: niedrig, normal, hoch oder dringend. Es steht in Ticketlisten neben dem Thema und in der Detailansicht bei den Zustandsangaben. Die Dringlichkeit bleibt dabei eine Einordnung – die Entscheidung, was zuerst bearbeitet wird, triffst du selbst.

Wann verwenden

  • In Ticketlisten, wenn die Reihenfolge der Bearbeitung von der Dringlichkeit abhängt.
  • In der Detailansicht eines Tickets, damit die Stufe ohne Lesen der ganzen Beschreibung sichtbar ist.
  • In Übergabelisten zwischen Schichten, wenn offene Punkte nach Dringlichkeit sortiert weitergegeben werden.
  • Wenn dieselbe Stufe überall gleich heißen soll: low, normal, high und urgent haben feste deutsche Beschriftungen aus PRIORITY_LABEL.

Wann nicht

  • Für den Bearbeitungsstand eines Tickets ist ein Statusabzeichen (StatusBadge) die richtige Wahl. Dringlichkeit und Zustand sind zwei verschiedene Angaben.
  • Für freie Kategorien und Schlagwörter nimm eine Kennzeichnung (Badge); sie kennt keine festen Stufen.
  • Für einen Anteil oder eine Reihenfolge von Schritten passen Fortschritt (Progress) oder Schrittfolge (Stepper).
  • Wenn die Einschätzung erklärt werden muss, gehört ein Satz daneben. Ein Abzeichen trägt nur das Wort.

Stufen

priority ist auf vier Werte festgelegt: low (niedrig), normal (normal), high (hoch) und urgent (dringend). Jede Stufe hat ein eigenes Symbol und eine eigene Farbe; die Bedeutung steht zusätzlich als Text daneben.

  • Heute noch bearbeiten – die Station wartet auf die Antwort.dringend
  • Bis zur nächsten Schicht erledigen.hoch
  • Im Laufe der Woche einplanen.normal
  • Kein Termin dahinter – der nächste freie Platz genügt.niedrig
Beispiel und Quelltext
alle.tsx
import { PriorityBadge } from "@neodin-eu/ui";

const STUFEN = [
  {
    priority: "urgent",
    text: "Heute noch bearbeiten – die Station wartet auf die Antwort.",
  },
  {
    priority: "high",
    text: "Bis zur nächsten Schicht erledigen.",
  },
  {
    priority: "normal",
    text: "Im Laufe der Woche einplanen.",
  },
  {
    priority: "low",
    text: "Kein Termin dahinter – der nächste freie Platz genügt.",
  },
] as const;

function Alle() {
  return (
    <ul className="flex w-full max-w-xl flex-col gap-2">
      {STUFEN.map((stufe) => (
        <li
          key={stufe.priority}
          className="flex items-center justify-between gap-4 rounded-lg border border-border bg-background px-3 py-2"
        >
          <span className="text-sm text-muted-foreground">{stufe.text}</span>
          <PriorityBadge priority={stufe.priority} />
        </li>
      ))}
    </ul>
  );
}

In der Ticketliste

Das Abzeichen steht in einer eigenen Spalte hinter dem Thema. Es bleibt einzeilig und richtet sich an der Textgröße aus, damit die Zeile ruhig bleibt.

TicketThemaPriorität
T-1042Dienstplan Dezemberhoch
T-1043Bettenbelegung Station 3dringend
T-1044Zugang zur Notaufnahmenormal
Beispiel und Quelltext
ticketliste.tsx
import {
  PriorityBadge,
  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>Priorität</TableHead>
          </TableRow>
        </TableHeader>
        <TableBody>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1042</TableCell>
            <TableCell>Dienstplan Dezember</TableCell>
            <TableCell>
              <PriorityBadge priority="high" />
            </TableCell>
          </TableRow>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1043</TableCell>
            <TableCell>Bettenbelegung Station 3</TableCell>
            <TableCell>
              <PriorityBadge priority="urgent" />
            </TableCell>
          </TableRow>
          <TableRow>
            <TableCell className="font-mono text-xs">T-1044</TableCell>
            <TableCell>Zugang zur Notaufnahme</TableCell>
            <TableCell>
              <PriorityBadge priority="normal" />
            </TableCell>
          </TableRow>
        </TableBody>
      </Table>
    </div>
  );
}

Barrierefreiheit

  • Jede Stufe verbindet Symbol und deutsches Wort. Im Komponententest werden für alle vier Werte die Beschriftung aus PRIORITY_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.
  • priority ist Pflicht und auf die vier 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 die Priorität in einer Tabellenspalte mit Überschrift; der Zusammenhang ist damit auch für Screenreader klar.

Props

Props von PriorityBadge
PropTypStandardPflichtBeschreibung
classNamestring–NeinAdditional classes for the badge.
priorityenum–JaTicket priority shown as icon and label.

Siehe auch