Komponenten
Ladeanzeige (Spinner)
StabilEin 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.
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
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. Ohnelabellautet der zugängliche Name „Wird geladen …“; im englischen Katalog „Loading …“. Beides ist im Komponententest abgesichert. - Ein eigenes
labelersetzt 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
| label | string | – | Nein | Accessible label; defaults to the loading message of the catalog. |