Komponenten
Menü (DropdownMenu)
StabilEine Liste von Aktionen hinter einer Schaltfläche – bearbeiten, zuweisen, absagen, ohne die Ansicht zu wechseln.
Ein Menü bündelt mehrere Aktionen hinter einem Auslöser: eine Schicht bearbeiten, ein Team zuweisen oder eine Schicht absagen. Es öffnet sich auf Klick und schließt nach der Auswahl, ohne die Seite zu verlassen.
Wann verwenden
- Für mehrere Aktionen, die zu einem Eintrag gehören – etwa die Zeile einer Schicht im Dienstplan.
- Wenn die Aktionen in der Ansicht zu viel Platz brauchen und nicht alle gleich wichtig sind.
- Für eine Auswahl aus wenigen festen Werten, etwa den Zeitraum einer Ticketliste.
Wann nicht
- Für die wichtigste Aktion einer Ansicht bleibt eine sichtbare Schaltfläche besser.
- Für genau einen Wert aus einer längeren Liste nimm
Select. - Für eine Auswahl, die immer sichtbar bleiben soll, passen
Tabsoder eine Optionsgruppe. - Für ein Menü mit verschachtelten Ebenen prüfe, ob eine einfache Liste nicht ausreicht.
Aktionen an einem Eintrag
DropdownMenu hält den Zustand, DropdownMenuTrigger ist der Auslöser,
DropdownMenuContent die Liste. DropdownMenuItem ist ein Eintrag,
DropdownMenuLabel beschriftet die Gruppe, DropdownMenuSeparator trennt sie.
Die Variante destructive markiert eine folgenreiche Aktion, sie ersetzt aber
keine Rückfrage.
import {
Button,
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuLabel,
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@neodin-eu/ui";
function Aktionen() {
return (
<DropdownMenu>
<DropdownMenuTrigger asChild>
<Button variant="outline">Aktionen</Button>
</DropdownMenuTrigger>
<DropdownMenuContent>
<DropdownMenuLabel>Schicht 3</DropdownMenuLabel>
<DropdownMenuItem>Bearbeiten</DropdownMenuItem>
<DropdownMenuItem>Team zuweisen</DropdownMenuItem>
<DropdownMenuSeparator />
<DropdownMenuItem variant="destructive">Schicht absagen</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
);
}Auswahl und Zustände
DropdownMenuCheckboxItem schaltet eine Option ein oder aus,
DropdownMenuRadioGroup mit DropdownMenuRadioItem wählt genau einen Wert.
Der Haken beziehungsweise der Punkt zeigen den Zustand; der Text bleibt
lesbar.
import {
Button,
DropdownMenu,
DropdownMenuCheckboxItem,
DropdownMenuContent,
DropdownMenuLabel,
DropdownMenuRadioGroup,
DropdownMenuRadioItem,
DropdownMenuSeparator,
DropdownMenuTrigger,
} from "@neodin-eu/ui";
function Ansicht() {
return (
<DropdownMenu>
<DropdownMenuTrigger asChild>
<Button variant="outline">Ansicht</Button>
</DropdownMenuTrigger>
<DropdownMenuContent className="w-56">
<DropdownMenuLabel>Zeitraum</DropdownMenuLabel>
<DropdownMenuRadioGroup defaultValue="heute">
<DropdownMenuRadioItem value="heute">Heute fällig</DropdownMenuRadioItem>
<DropdownMenuRadioItem value="woche">Diese Woche</DropdownMenuRadioItem>
<DropdownMenuRadioItem value="alle">Alle offenen</DropdownMenuRadioItem>
</DropdownMenuRadioGroup>
<DropdownMenuSeparator />
<DropdownMenuCheckboxItem defaultChecked>Nur meine Tickets</DropdownMenuCheckboxItem>
<DropdownMenuCheckboxItem>Erledigte anzeigen</DropdownMenuCheckboxItem>
</DropdownMenuContent>
</DropdownMenu>
);
}Barrierefreiheit
DropdownMenuTriggerrendert mitasChildeine echte Schaltfläche. Im Komponententest öffnetEnterauf dem fokussierten Auslöser das Menü.- Die geöffnete Liste hat die Rolle
menu, jeder Eintrag die Rollemenuitem. Der Test findet beides über diese Rollen. - Die Pfeiltasten bewegen den Fokus zwischen den Einträgen,
Escapeschließt das Menü und setzt den Fokus zurück auf den Auslöser. Das ist das Verhalten der Radix-Grundlage. - Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
- Eine gesperrte Aktion bleibt sichtbar und wird von der Tastatur übersprungen; sie darf nicht die einzige Erklärung für einen Zustand sein.
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 | – |
| disabled | 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 | – |
| inset | boolean | – | Nein | Indents the item to align with checkbox and radio items. |
| variant | enum | default | Nein | Visual style of the item; `"destructive"` marks a dangerous action. |