Komponenten
Platzhalter (Skeleton)
StabilReserviert die Form des späteren Inhalts, während Daten noch laden.
Ein Platzhalter nimmt die Form des späteren Inhalts ein, solange er lädt: eine Ticketliste, eine Karte, eine Tabelle. Dadurch springt das Layout beim Eintreffen der Daten nicht, und die Ansicht wirkt ruhig statt leer.
Wann verwenden
- Wenn Daten länger als einen kurzen Moment laden und die Form des Inhalts schon feststeht.
- In Listen, Karten und Tabellen, um Zeilen, Spalten und Schaltflächen zu reservieren.
- Wenn du einen Sprung des Layouts vermeiden willst, sobald die Daten eintreffen.
- Wenn mehrere Bereiche gleichzeitig laden und jeder seinen eigenen Platzhalter bekommt.
Wann nicht
- Für einen Vorgang unter einer Sekunde genügt eine Ladeanzeige (
Spinner); ein flackernder Platzhalter stört mehr, als er hilft. - Für einen Vorgang mit bekanntem Fortschritt ist ein Balken genauer
(
Progress). - Als Dauerzustand ist ein Platzhalter nie richtig: Bleibt der Inhalt aus, gehört ein Leerzustand oder ein Fehlerzustand hin.
- Für einen einzelnen Wert genügt ein kurzer Ladehinweis am Feld.
In einer Liste
Setze Höhe und Breite über className, etwa h-3.5 und w-2/5. Die Form
folgt dem echten Inhalt: ein rundes Feld für das Avatar, zwei Zeilen für
Titel und Beschreibung, ein Feld für die Kennzeichnung. Das Beispiel
kennzeichnet den Bereich mit role="status" und einer Beschriftung, damit
Screenreader den Ladezustand einmal ansagen.
import { Skeleton } from "@neodin-eu/ui";
function Liste() {
return (
<div
role="status"
aria-label="Tickets werden geladen"
aria-busy="true"
className="flex w-full max-w-md flex-col gap-3"
>
{[0, 1, 2].map((zeile) => (
<div
key={zeile}
className="flex items-center gap-3 rounded-lg border border-border bg-background p-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.5 w-3/5" />
</div>
<Skeleton className="h-6 w-16 rounded-full" />
</div>
))}
</div>
);
}In einer Karte
Bei einer Karte lohnt sich der Platzhalter für Kopf, Text und Aktionen. So bleibt die Höhe stabil, wenn die echten Daten eintreffen. Runde Ecken und Abstände entsprechen der fertigen Karte.
import { Skeleton } from "@neodin-eu/ui";
function Karte() {
return (
<div className="w-full max-w-md rounded-xl border border-border bg-background p-5">
<div className="flex items-center justify-between gap-4">
<Skeleton className="h-4 w-32" />
<Skeleton className="h-6 w-20 rounded-full" />
</div>
<div className="mt-5 flex flex-col gap-3">
<Skeleton className="h-3.5 w-full" />
<Skeleton className="h-3.5 w-11/12" />
<Skeleton className="h-3.5 w-3/4" />
</div>
<div className="mt-6 flex gap-3">
<Skeleton className="h-9 w-28" />
<Skeleton className="h-9 w-28" />
</div>
</div>
);
}Barrierefreiheit
Skeletonrendert ein leeresdivmitdata-slot="skeleton"und der Klasseanimate-pulse. Ohne Text und ohne Rolle wird es von Screenreadern nicht angesagt; das ist im Komponententest über das Attribut und die Klasse abgesichert.- Den Ladezustand meldet der umgebende Bereich. Das Beispiel setzt dafür
role="status"mitaria-label="Tickets werden geladen"undaria-busy="true". - Die Farbe
bg-mutedist eine Flächenfarbe ohne Text; Kontrastanforderungen an Text gelten hier nicht. - Der Platzhalter ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |