Komponenten
Dialog
StabilEine 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.
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.
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 liefertDialogTitle. Im Komponententest wird er übergetByRole("dialog")gefunden. Escapeschließ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.
DialogContentbringt einen Schließen-Knopf mit; sein Name ist „Schließen“. MitshowCloseButton={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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| showCloseButton | boolean | true | Nein | Renders the close button in the top-right corner; defaults to `true`. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |