Zum Inhalt springen
Dokumentation

Komponenten

Menü (DropdownMenu)

Stabil

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

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

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

  • DropdownMenuTrigger rendert mit asChild eine echte Schaltfläche. Im Komponententest öffnet Enter auf dem fokussierten Auslöser das Menü.
  • Die geöffnete Liste hat die Rolle menu, jeder Eintrag die Rolle menuitem. Der Test findet beides über diese Rollen.
  • Die Pfeiltasten bewegen den Fokus zwischen den Einträgen, Escape schließ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

Props von DropdownMenu
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von DropdownMenuTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
Props von DropdownMenuContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von DropdownMenuItem
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
insetboolean–NeinIndents the item to align with checkbox and radio items.
variantenumdefaultNeinVisual style of the item; `"destructive"` marks a dangerous action.

Siehe auch