Zum Inhalt springen
Dokumentation

Komponenten

Dialog

Stabil

Eine Unterbrechung mit eigenem Fokus – Details, Formulare und Rückfragen, die nicht in die Seite passen.

Ein Dialog unterbricht die laufende Arbeit und legt den Fokus auf eine Aufgabe: eine Übergabe quittieren, eine Rückmeldung erfassen, eine kurze Auswahl treffen. Anders als ein Popover bleibt er im Vordergrund, bis du ihn schließt.

Wann verwenden

  • Für eine Aufgabe, die Aufmerksamkeit braucht und nicht nebenbei erledigt werden soll, etwa die Übergabe am Schichtende.
  • Für ein kurzes Formular mit wenigen Feldern, das ohne Seitenwechsel auskommt.
  • Für Details, die du nur bei Bedarf öffnest – etwa die letzte Änderung am Dienstplan.

Wann nicht

  • Für kurze Hinweise genügt ein Popover oder ein Tooltip; ein Dialog blockiert mehr, als nötig.
  • Für eine Rückfrage vor einer folgenreichen Aktion nimm den Bestätigungsdialog (AlertDialog).
  • Für Inhalte, die du beim Lesen der Seite vergleichen willst, ist ein Seitenpanel besser: Es verdeckt den Rest der Seite nicht.
  • Für lange Formulare mit vielen Schritten ist eine eigene Seite ruhiger.

Übergabe quittieren

Dialog hält den offenen Zustand, DialogTrigger öffnet, DialogContent zeigt den Inhalt. Titel und Beschreibung kommen aus DialogTitle und DialogDescription; sie benennen den Dialog für Screenreader. Die Aktionen stehen in DialogFooter, ein DialogClose schließt den Dialog.

Beispiel und Quelltext
uebergabe.tsx
import {
  Button,
  Dialog,
  DialogClose,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
} from "@neodin-eu/ui";

function Uebergabe() {
  return (
    <Dialog>
      <DialogTrigger asChild>
        <Button variant="outline">Übergabe öffnen</Button>
      </DialogTrigger>
      <DialogContent>
        <DialogHeader>
          <DialogTitle>Übergabe Station 3</DialogTitle>
          <DialogDescription>
            Frühdienst an Spätdienst, sieben Betten belegt. Prüfe die offenen Punkte vor dem
            Schichtwechsel.
          </DialogDescription>
        </DialogHeader>
        <ul className="list-disc space-y-1 pl-5 text-sm">
          <li>Das Übergabeprotokoll liegt am Stationsplatz.</li>
          <li>Die Nachtschicht ist doppelt besetzt.</li>
          <li>Zwei Fortbildungen warten noch auf die Freigabe.</li>
        </ul>
        <DialogFooter>
          <DialogClose asChild>
            <Button variant="outline">Abbrechen</Button>
          </DialogClose>
          <DialogClose asChild>
            <Button>Übergabe quittieren</Button>
          </DialogClose>
        </DialogFooter>
      </DialogContent>
    </Dialog>
  );
}

Formular im Dialog

Ein Formular im Dialog lohnt sich nur für wenige Felder. Mit open und onOpenChange steuerst du den Zustand selbst – etwa um den Dialog nach dem Absenden zu schließen und eine Rückmeldung auf der Seite zu zeigen.

Der Dialog bleibt offen, bis du ihn schließt.

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

import {
  Button,
  Dialog,
  DialogContent,
  DialogDescription,
  DialogFooter,
  DialogHeader,
  DialogTitle,
  DialogTrigger,
  Input,
  Label,
  Textarea,
} from "@neodin-eu/ui";

function Formular() {
  const [offen, setOffen] = React.useState(false);
  const [gesendet, setGesendet] = React.useState(false);

  function absenden(event: React.FormEvent<HTMLFormElement>) {
    event.preventDefault();
    setOffen(false);
    setGesendet(true);
  }

  return (
    <div className="flex w-full max-w-md flex-col items-start gap-3">
      <Dialog open={offen} onOpenChange={setOffen}>
        <DialogTrigger asChild>
          <Button variant="secondary">Rückmeldung erfassen</Button>
        </DialogTrigger>
        <DialogContent>
          <DialogHeader>
            <DialogTitle>Rückmeldung zur Schicht</DialogTitle>
            <DialogDescription>
              Was lief gut, was soll beim nächsten Mal anders sein?
            </DialogDescription>
          </DialogHeader>
          <form id="rueckmeldung" onSubmit={absenden} className="flex flex-col gap-4">
            <div className="flex flex-col gap-2">
              <Label htmlFor="rueckmeldung-station">Station</Label>
              <Input id="rueckmeldung-station" name="station" placeholder="Station 3" />
            </div>
            <div className="flex flex-col gap-2">
              <Label htmlFor="rueckmeldung-text">Anmerkung</Label>
              <Textarea
                id="rueckmeldung-text"
                name="anmerkung"
                rows={3}
                placeholder="Zum Beispiel: Die Übergabe war gut vorbereitet."
              />
            </div>
          </form>
          <DialogFooter>
            <Button type="button" variant="outline" onClick={() => setOffen(false)}>
              Abbrechen
            </Button>
            <Button type="submit" form="rueckmeldung">
              Absenden
            </Button>
          </DialogFooter>
        </DialogContent>
      </Dialog>
      <p className="text-xs text-muted-foreground" role="status">
        {gesendet
          ? "Danke, die Rückmeldung liegt beim Team."
          : "Der Dialog bleibt offen, bis du ihn schließt."}
      </p>
    </div>
  );
}

Barrierefreiheit

  • Der offene Dialog hat die Rolle dialog; den zugänglichen Namen liefert DialogTitle. Im Komponententest wird er über getByRole("dialog") gefunden.
  • Escape schließt den Dialog und setzt den Fokus zurück auf den Auslöser. Das ist im Komponententest abgesichert.
  • Solange der Dialog offen ist, hält Radix den Fokus im Dialog und blendet den Rest der Seite für Screenreader aus.
  • DialogContent bringt einen Schließen-Knopf mit; sein Name ist „Schließen“. Mit showCloseButton={false} lässt er sich weglassen, dann braucht es eine sichtbare Aktion zum Schließen.
  • Der offene Dialog ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Dialog
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von DialogContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
showCloseButtonbooleantrueNeinRenders the close button in the top-right corner; defaults to `true`.
Props von DialogTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch