Zum Inhalt springen
Dokumentation

Komponenten

Ladeanzeige (Spinner)

Stabil

Ein kleines Zeichen für laufende Arbeit – mit Meldung für Screenreader.

Eine Ladeanzeige zeigt, dass gerade etwas passiert: die Tickets werden geladen, die Belegung wird aktualisiert. Sie ist klein und ersetzt keinen Inhalt, sie begleitet ihn.

Wann verwenden

  • Für kurze Ladevorgänge, bei denen der Inhalt gleich erscheint.
  • In einer Schaltfläche oder an der Stelle, an der der Inhalt später steht.
  • Wenn die Meldung für Screenreader wichtig ist und nicht nur das Symbol gesehen werden soll.

Wann nicht

  • Für einen Vorgang mit bekanntem Fortschritt ist ein Balken genauer; die Ladeanzeige sagt nur „es läuft“.
  • Für einen ganzen Bereich, der noch leer ist, passt ein Platzhalter (Skeleton) besser.
  • Für einen abgeschlossenen Zustand gehört kein Ladezeichen in die Ansicht.
  • Für eine kurze Einblendung nach einer Aktion genügt eine Einblendung (toast).

In einer Ansicht

Die Ladeanzeige steht neben dem Text, der beschreibt, was geladen wird. label setzt die Meldung für Screenreader; ohne label gilt „Wird geladen …“ aus dem Katalog.

Beispiel und Quelltext
tabelle.tsx
import * as React from "react";

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

function Tabelle() {
  const [laedt, setLaedt] = React.useState(false);

  return (
    <div className="flex w-full max-w-md flex-col gap-3">
      <Button disabled={laedt} onClick={() => setLaedt(true)}>
        Tickets laden
      </Button>
      {laedt ? (
        <div className="flex items-center gap-2 text-sm text-muted-foreground">
          <Spinner label="Tickets werden geladen" />
          <span>Tickets werden geladen …</span>
        </div>
      ) : null}
    </div>
  );
}

Größe und Farbe

Das Symbol ist quadratisch und erbt die Textfarbe. Über className lässt es sich kleiner setzen oder hervorheben; die Meldung bleibt davon unberührt.

Standard mit der Meldung aus dem Katalog
Eigene Meldung und eigene Farbe
Beispiel und Quelltext
varianten.tsx
import { Spinner } from "@neodin-eu/ui";

function Varianten() {
  return (
    <div className="flex w-full max-w-md flex-col gap-4">
      <div className="flex items-center gap-2 text-sm">
        <Spinner />
        <span>Standard mit der Meldung aus dem Katalog</span>
      </div>
      <div className="flex items-center gap-2 text-sm">
        <Spinner label="Belegung wird aktualisiert" className="text-foreground" />
        <span>Eigene Meldung und eigene Farbe</span>
      </div>
    </div>
  );
}

Barrierefreiheit

  • Die Ladeanzeige hat die Rolle status. Ohne label lautet der zugängliche Name „Wird geladen …“; im englischen Katalog „Loading …“. Beides ist im Komponententest abgesichert.
  • Ein eigenes label ersetzt die Meldung; im Test wird der Name „Daten werden geladen“ gefunden.
  • Das Symbol ist aria-hidden, die Aussage kommt aus dem Text der Rolle.
  • Bei reduzierter Bewegung (prefers-reduced-motion) steht das Symbol still; die Klassen dafür sind im Komponententest geprüft.
  • Die Ladeanzeige ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Spinner
PropTypStandardPflichtBeschreibung
classNamestring–Nein–
labelstring–NeinAccessible label; defaults to the loading message of the catalog.

Siehe auch