Komponenten
Bestätigungsdialog (AlertDialog)
StabilEine folgenreiche Aktion bestätigen lassen – klar, knapp und ohne Ausweg per Klick daneben.
Der Bestätigungsdialog fragt nach, bevor etwas Folgen hat: einen Dienstplan veröffentlichen, eine Schicht abschließen, einen Eintrag löschen. Er nennt die Folge in einem Satz und bietet genau zwei Wege – bestätigen oder abbrechen.
Wann verwenden
- Vor einer Aktion, die sich nicht zurücknehmen lässt oder für viele sichtbar wird, etwa „Dienstplan veröffentlichen“.
- Wenn die Folge erklärt werden muss und nicht nur der Name der Aktion.
- Wenn du sicher sein willst, dass die Aktion bewusst ausgelöst wurde.
Wann nicht
- Für jede Aktion eine Rückfrage zu zeigen nervt. Speichern und Schließen brauchen keine Bestätigung.
- Für Details oder Formulare ist der Dialog die richtige Wahl; der Bestätigungsdialog trägt nur eine Entscheidung.
- Für einen Hinweis ohne Entscheidung genügt ein Alert oder eine Meldung auf der Seite.
Aufbau
AlertDialog hält den Zustand, AlertDialogTrigger öffnet,
AlertDialogContent zeigt Titel (AlertDialogTitle) und Erklärung
(AlertDialogDescription). Im Fuß stehen AlertDialogCancel und
AlertDialogAction; der Abbruch ist die ruhigere Outline-Variante, die Aktion
trägt die primäre Variante von Button.
Rückfrage vor dem Veröffentlichen
Veröffentlichen ist folgenreich, aber nicht zerstörend. Soll die Aktion
zusätzlich als destruktiv erkennbar sein, gibst du ihr die
destructive-Variante über className mit – im Beispiel trägt
„Veröffentlichen“ diese Variante.
import {
AlertDialog,
AlertDialogAction,
AlertDialogCancel,
AlertDialogContent,
AlertDialogDescription,
AlertDialogFooter,
AlertDialogHeader,
AlertDialogTitle,
AlertDialogTrigger,
Button,
buttonVariants,
} from "@neodin-eu/ui";
function Dienstplan() {
return (
<AlertDialog>
<AlertDialogTrigger asChild>
<Button>Dienstplan veröffentlichen</Button>
</AlertDialogTrigger>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>Dienstplan veröffentlichen?</AlertDialogTitle>
<AlertDialogDescription>
Der Plan für die kommende Woche wird für alle Stationen sichtbar. Danach sind nur noch
Korrekturen möglich.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel>Abbrechen</AlertDialogCancel>
<AlertDialogAction className={buttonVariants({ variant: "destructive" })}>
Veröffentlichen
</AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>
);
}Ohne destruktive Variante
Für eine gewöhnliche Bestätigung bleibt die Aktion primär. Das Beispiel markiert eine Schicht als erledigt und schiebt offene Aufgaben in die Übergabe.
import {
AlertDialog,
AlertDialogAction,
AlertDialogCancel,
AlertDialogContent,
AlertDialogDescription,
AlertDialogFooter,
AlertDialogHeader,
AlertDialogTitle,
AlertDialogTrigger,
Button,
} from "@neodin-eu/ui";
function Schicht() {
return (
<AlertDialog>
<AlertDialogTrigger asChild>
<Button variant="outline">Schicht abschließen</Button>
</AlertDialogTrigger>
<AlertDialogContent>
<AlertDialogHeader>
<AlertDialogTitle>Schicht abschließen?</AlertDialogTitle>
<AlertDialogDescription>
Die Schicht wird als erledigt markiert. Offene Aufgaben wandern in die Übergabe für das
nächste Team.
</AlertDialogDescription>
</AlertDialogHeader>
<AlertDialogFooter>
<AlertDialogCancel>Abbrechen</AlertDialogCancel>
<AlertDialogAction>Abschließen</AlertDialogAction>
</AlertDialogFooter>
</AlertDialogContent>
</AlertDialog>
);
}Barrierefreiheit
- Der offene Dialog hat die Rolle
alertdialog; im Komponententest wird er übergetByRole("alertdialog")gefunden. Escapeschließt den Dialog und setzt den Fokus zurück auf den Auslöser. Das ist im Komponententest abgesichert.Tabbleibt innerhalb des Dialogs: Der Komponententest springt sechsmal weiter und findet den Fokus jedes Mal im Dialog.- Abbrechen und die Aktion sind über die
Button-Varianten gestaltet und dadurch auch farblich unterscheidbar. Ohne eigene Klasse trägt die Aktion die primäre Fläche, der Abbruch den Rahmen; im Komponententest geprüft. - Der offene Dialog ist im Komponententest in hell und dunkel frei von axe-Verstößen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |