Komponenten
Leerzustand (EmptyState)
StabilErklärt eine leere Fläche und bietet den nächsten Schritt an.
Ein Leerzustand erklärt, warum eine Fläche leer ist, und bietet den nächsten Schritt an: „Keine offenen Tickets“ ist kein Fehler, sondern ein Ergebnis. Ohne diesen Satz wirkt eine leere Liste wie eine kaputte Ansicht.
Wann verwenden
- Wenn eine Liste, Tabelle oder ein Bereich erfolgreich geladen wurde, aber keine Einträge enthält.
- Wenn die Leere erwartbar ist, etwa bei einer neuen Station oder nach einem engen Filter.
- Wenn ein nächster Schritt angeboten werden soll: „Ticket anlegen“, „Filter zurücksetzen“.
- Wenn der Filter aktiv ist und erklärt werden muss, warum nichts passt.
Wann nicht
- Solange noch geladen wird, gehört ein Platzhalter (
Skeleton) hin. - Wenn ein Fehler die Ursache ist, erklärt ein Fehlerzustand (
ErrorState) das Problem und den erneuten Versuch. - Für eine einzelne fehlende Zeile in einer Tabelle genügt ein kursiver Hinweis in der Zelle.
- Für eine Meldung, die eine Aktion bestätigt, genügt eine Einblendung
(
toast).
Aufbau
title ist Pflicht und benennt die Lage. description erklärt sie in einem
Satz. action nimmt eine Schaltfläche oder einen Link auf. Ohne icon zeigt
der Leerzustand das Postfach-Symbol.
Keine offenen Tickets
Sobald ein Ticket eingeht, erscheint es hier. Du kannst jederzeit ein neues Ticket erfassen.
import { Button, EmptyState } from "@neodin-eu/ui";
function Tickets() {
return (
<div className="w-full max-w-md rounded-xl border border-border bg-background">
<EmptyState
title="Keine offenen Tickets"
description="Sobald ein Ticket eingeht, erscheint es hier. Du kannst jederzeit ein neues Ticket erfassen."
action={<Button size="sm">Ticket anlegen</Button>}
/>
</div>
);
}Eigenes Symbol und Filter
icon ersetzt das Standardsymbol, etwa eine Lupe ohne Treffer oder einen
leeren Kalender. Die Aktion setzt den Filter zurück oder führt zum Anlegen.
Wähle ein Symbol, das die Ursache zeigt, nicht eines, das nur dekoriert.
Keine Treffer
Für diese Station und diesen Zeitraum gibt es keine Einträge.
Kein Dienstplan veröffentlicht
Der Plan für Dezember erscheint am 25. November.
import { CalendarOff, SearchX } from "lucide-react";
import { Button, EmptyState } from "@neodin-eu/ui";
function Filter() {
return (
<div className="grid w-full gap-4 sm:grid-cols-2">
<div className="rounded-xl border border-border bg-background">
<EmptyState
icon={SearchX}
title="Keine Treffer"
description="Für diese Station und diesen Zeitraum gibt es keine Einträge."
action={
<Button variant="outline" size="sm">
Filter zurücksetzen
</Button>
}
/>
</div>
<div className="rounded-xl border border-border bg-background">
<EmptyState
icon={CalendarOff}
title="Kein Dienstplan veröffentlicht"
description="Der Plan für Dezember erscheint am 25. November."
/>
</div>
</div>
);
}Barrierefreiheit
EmptyStaterendert einendivmit Symbolkreis, Titel, Beschreibung und Aktion. Der Text steht in Dokumentreihenfolge und wird beim Durchlesen erfasst; eine eigene Rolle trägt der Bereich nicht.- Das Symbol ist
aria-hidden; Titel und Beschreibung tragen die Aussage. Im Komponententest werden Titel, Beschreibung und die Schaltfläche über ihre Namen gefunden. - Ohne
descriptionundactionbleibt nur der Titel übrig; auch dieser Fall ist im Komponententest abgesichert. - Die Aktion ist eine normale Schaltfläche oder ein Link und folgt damit den Tastaturregeln des Elements.
- Der Leerzustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| action | ReactNode | – | Nein | Extra content below the text, such as a button. |
| className | string | – | Nein | – |
| description | ReactNode | – | Nein | Explanatory text below the title. |
| icon | LucideIcon | – | Nein | Icon shown above the title; defaults to an inbox icon. |
| title | ReactNode | – | Ja | Short heading describing the empty state. |