Zum Inhalt springen
Dokumentation

Komponenten

Leerzustand (EmptyState)

Stabil

Erklä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.

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

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

  • EmptyState rendert einen div mit 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 description und action bleibt 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

Props von EmptyState
PropTypStandardPflichtBeschreibung
actionReactNode–NeinExtra content below the text, such as a button.
classNamestring–Nein–
descriptionReactNode–NeinExplanatory text below the title.
iconLucideIcon–NeinIcon shown above the title; defaults to an inbox icon.
titleReactNode–JaShort heading describing the empty state.

Siehe auch