Zum Inhalt springen
Dokumentation

Komponenten

Bestätigungsdialog (AlertDialog)

Stabil

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

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

Beispiel und Quelltext
schicht.tsx
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 über getByRole("alertdialog") gefunden.
  • Escape schließt den Dialog und setzt den Fokus zurück auf den Auslöser. Das ist im Komponententest abgesichert.
  • Tab bleibt 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

Props von AlertDialog
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von AlertDialogContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von AlertDialogAction
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
Props von AlertDialogCancel
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch