Zum Inhalt springen
Dokumentation

Komponenten

Platzhalter (Skeleton)

Stabil

Reserviert 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.

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

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

  • Skeleton rendert ein leeres div mit data-slot="skeleton" und der Klasse animate-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" mit aria-label="Tickets werden geladen" und aria-busy="true".
  • Die Farbe bg-muted ist 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

Props von Skeleton
PropTypStandardPflichtBeschreibung
classNamestring–Nein–

Siehe auch