Zum Inhalt springen
Dokumentation

Muster

Leerzustände

Stabil

Leer, fehlgeschlagen oder noch am Laden: drei Zustände, die eine Fläche erklären, und wann welcher passt.

Eine Fläche ohne Inhalt kann drei Ursachen haben: Es gibt nichts, das Laden ist fehlgeschlagen, oder es lädt noch. Jede Ursache bekommt einen eigenen Baustein. Wer sie vertauscht, zeigt eine leere Liste als Fehler oder lässt Nutzer auf eine Fläche starren, die noch arbeitet.

Wann welcher Zustand

LageBausteinWas er sagtNächster Schritt
Erfolgreich geladen, aber keine EinträgeEmptyStateWarum die Fläche leer istAnlegen, Filter zurücksetzen
Laden oder Übertragung fehlgeschlagenErrorStateWas nicht geklappt hatErneut versuchen
Daten sind noch unterwegsSkeletonDie Form des späteren InhaltsWarten, nichts anklicken

Leer: nichts da, aber alles in Ordnung

EmptyState nennt die Lage und bietet eine Aktion an. Das Beispiel zeigt die Übergaben des Frühdienstes: Es ist Montag, es wurde noch nichts eingetragen. „Keine offenen Übergaben“ ist ein Ergebnis, kein Fehler.

Keine offenen Übergaben

Für den Frühdienst am Montag ist noch nichts hinterlegt. Sobald etwas eingetragen wird, erscheint es hier.

Beispiel und Quelltext
leerzustand-leer.tsx
import { Inbox } from "lucide-react";

import { Button, EmptyState } from "@neodin-eu/ui";

function LeerzustandLeer() {
  return (
    <div className="w-full max-w-md rounded-xl border border-border bg-background">
      <EmptyState
        icon={Inbox}
        title="Keine offenen Übergaben"
        description="Für den Frühdienst am Montag ist noch nichts hinterlegt. Sobald etwas eingetragen wird, erscheint es hier."
        action={<Button size="sm">Übergabe anlegen</Button>}
      />
    </div>
  );
}

Fehlgeschlagen: etwas ist schiefgelaufen

ErrorState erklärt den Fehler und bietet mit onRetry einen erneuten Versuch an. Das Beispiel lädt beim zweiten Versuch eine kurze Bestätigung, damit der Unterschied sichtbar wird. Ohne onRetry bleibt nur der Text – das ist nur dann richtig, wenn ein erneuter Versuch nichts ändern würde.

Etwas ist schiefgelaufen

Die Übergaben konnten nicht geladen werden. Prüfe die Verbindung und versuche es erneut.

Beispiel und Quelltext
leerzustand-fehler.tsx
import * as React from "react";

import { Button, ErrorState } from "@neodin-eu/ui";

function LeerzustandFehler() {
  const [geladen, setGeladen] = React.useState(false);

  if (geladen) {
    return (
      <div className="flex w-full max-w-md flex-col items-center gap-3 rounded-xl border border-border bg-background p-6 text-center">
        <p className="text-sm font-semibold text-foreground">Übergaben geladen</p>
        <p className="text-sm text-muted-foreground">
          Die Liste der offenen Übergaben ist wieder verfügbar.
        </p>
        <Button variant="outline" size="sm" onClick={() => setGeladen(false)}>
          Fehler erneut zeigen
        </Button>
      </div>
    );
  }

  return (
    <div className="w-full max-w-md rounded-xl border border-border bg-background">
      <ErrorState
        description="Die Übergaben konnten nicht geladen werden. Prüfe die Verbindung und versuche es erneut."
        onRetry={() => setGeladen(true)}
      />
    </div>
  );
}

Laden: die Form steht schon fest

Skeleton reserviert Höhe und Breite des späteren Inhalts. Das Beispiel bildet eine Liste mit Avatar, zwei Textzeilen und einer Kennzeichnung nach. Der umgebende Bereich trägt role="status", aria-label und aria-busy, damit Screenreader den Ladezustand einmal ansagen; die Platzhalter selbst bleiben stumm.

Beispiel und Quelltext
leerzustand-laden.tsx
import { Skeleton } from "@neodin-eu/ui";

const zeilen = ["a", "b", "c"] as const;

function LeerzustandLaden() {
  return (
    <div
      role="status"
      aria-label="Übergaben werden geladen"
      aria-busy="true"
      className="flex w-full max-w-md flex-col gap-3 rounded-xl border border-border bg-background p-4"
    >
      {zeilen.map((zeile) => (
        <div key={zeile} className="flex items-center gap-3">
          <Skeleton className="size-9 shrink-0 rounded-full" />
          <div className="flex flex-1 flex-col gap-2">
            <Skeleton className="h-3.5 w-2/5" />
            <Skeleton className="h-3 w-3/5" />
          </div>
          <Skeleton className="h-6 w-16 shrink-0 rounded-full" />
        </div>
      ))}
    </div>
  );
}

Die Zustände ablösen

In der Anwendung folgen sie aufeinander: Beim Öffnen zeigt die Fläche den Platzhalter, nach dem Laden die Daten oder den Leerzustand, bei einem Fehler den Fehlerzustand mit Wiederholen. Ein leerer Zustand darf nie aus einem Fehler entstehen, und ein Platzhalter darf nie dauerhaft stehen bleiben.

Für eine einzelne fehlende Zeile genügt ein kursiver Hinweis in der Zelle. Für eine Meldung, die eine Aktion bestätigt, ist eine Einblendung (toast) richtig; sie ersetzt keinen Zustand der ganzen Fläche.

Siehe auch