Komponenten
Meldungen (Toast)
StabilKurze Rückmeldungen nach einer Aktion – bestätigen, ohne zu unterbrechen.
Eine Meldung bestätigt eine Aktion kurz und verschwindet wieder: „Dienstplan gespeichert“, „Übertragung fehlgeschlagen“. Sie unterbricht die Arbeit nicht, sondern begleitet sie. Für etwas, das stehen bleiben muss, ist ein Hinweis die richtige Form.
Wann verwenden
- Nach dem Speichern, Löschen oder Übertragen, wenn die Ansicht bleibt, wo sie ist.
- Für einen kurzen Hinweis, der nicht im Seitenfluss bleiben muss.
- Für das Ergebnis einer Aktion im Hintergrund, etwa einer Synchronisierung.
- Wenn die Meldung nur bestätigt und keinen weiteren Schritt verlangt.
Wann nicht
- Für eine Meldung, die gelesen und vielleicht später beachtet werden muss,
gehört ein Hinweis (
Alert) in den Seitenfluss. - Für Ausfälle und Wartung über die ganze Ansicht ist ein Banner (
Banner) besser. - Für Feldvalidierung gehört der Text an das Feld.
- Für eine Entscheidung, die eine Antwort verlangt, braucht es einen Dialog, keine Meldung, die nach vier Sekunden verschwindet.
Einmal mounten
Der Toaster wird einmal pro Anwendung gerendert, in dieser Doku im
Root-Layout (apps/site/src/app/layout.tsx). Alle Client-Module rufen danach
nur noch toast() auf. Ein zweiter Toaster würde jede Meldung doppelt
anzeigen. Die Beispiele unten mounten deshalb keinen eigenen.
Erfolg
toast.success() zeigt eine Bestätigung mit Titel. description ergänzt
einen Satz, duration bestimmt in Millisekunden, wie lange die Meldung
bleibt; ohne Angabe gilt der Standard der Bibliothek.
Die Einblendung erscheint unten rechts und verschwindet nach einigen Sekunden.
import { Button, toast } from "@neodin-eu/ui";
function Gespeichert() {
return (
<div className="flex w-full max-w-md flex-col gap-2">
<Button
onClick={() =>
toast.success("Dienstplan gespeichert", {
description: "Die Änderungen sind für alle Stationen sichtbar.",
duration: 8000,
})
}
>
Dienstplan speichern
</Button>
<p className="text-sm text-muted-foreground">
Die Einblendung erscheint unten rechts und verschwindet nach einigen Sekunden.
</p>
</div>
);
}Neutral und Fehler
toast() ohne Zusatz zeigt eine neutrale Meldung, toast.error() eine
Fehlermeldung mit eigener Farbe und eigenem Symbol. Beide Formen bleiben
knapp: eine Aussage, höchstens ein erklärender Satz.
import { Button, toast } from "@neodin-eu/ui";
function Fehler() {
return (
<div className="flex flex-wrap gap-2">
<Button
variant="outline"
onClick={() =>
toast("Entwurf gespeichert", {
description: "Der Entwurf bleibt 30 Tage erhalten.",
duration: 8000,
})
}
>
Entwurf speichern
</Button>
<Button
variant="destructive"
onClick={() =>
toast.error("Übertragung fehlgeschlagen", {
description: "Die Schnittstelle hat nicht geantwortet. Versuche es später erneut.",
duration: 8000,
})
}
>
Übertragung testen
</Button>
</div>
);
}Barrierefreiheit
- Die Bibliothek rendert den
Toasterals Live-Bereich mitaria-live="polite". Neue Meldungen werden von Screenreadern angekündigt, ohne den Fokus zu stehlen oder die aktuelle Arbeit zu unterbrechen. - Titel und Beschreibung sind Text. Das Symbol der Meldung ist dekoriert und trägt keine eigene Aussage.
- Weil die Meldung nach einigen Sekunden verschwindet, darf sie keine Information tragen, die später noch gebraucht wird.
- Der Komponententest prüft, dass eine Meldung sichtbar wird und in hell und dunkel frei von axe-Verstößen ist.
- Die Einblendung nach einem Klick wird im Seitentest geprüft: Meldung sichtbar, keine axe-Verstöße im offenen Zustand.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | – |
toast() selbst ist eine Funktion, keine Komponente. Sie nimmt den Text als
erstes Argument und Optionen wie description, duration, action und
cancel entgegen.