Muster
Leerzustände
StabilLeer, 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
| Lage | Baustein | Was er sagt | Nächster Schritt |
|---|---|---|---|
| Erfolgreich geladen, aber keine Einträge | EmptyState | Warum die Fläche leer ist | Anlegen, Filter zurücksetzen |
| Laden oder Übertragung fehlgeschlagen | ErrorState | Was nicht geklappt hat | Erneut versuchen |
| Daten sind noch unterwegs | Skeleton | Die Form des späteren Inhalts | Warten, 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.
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.
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.
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.