Zum Inhalt springen
Dokumentation

Komponenten

Kontextmenü (ContextMenu)

Stabil

Aktionen direkt am Objekt – per Rechtsklick oder Tastatur, etwa auf einer Bettenzeile im Dienstplan.

Ein Kontextmenü öffnet sich am Objekt selbst: Rechtsklick auf eine Bettenzeile, die Karte einer Schicht oder einen Eintrag in der Liste. Es zeigt nur die Aktionen, die an dieser Stelle sinnvoll sind.

Wann verwenden

  • Für Aktionen, die eindeutig zu einem Objekt gehören – Bett bearbeiten, Verlegung planen, Bett freigeben.
  • Wenn die Liste dicht ist und zusätzliche Schaltflächen in jeder Zeile stören würden.
  • Als Ergänzung zur Tastaturbedienung: Das Menü lässt sich auch ohne Maus öffnen.

Wann nicht

  • Wichtige Aktionen dürfen nicht ausschließlich im Kontextmenü stecken. Wer den Rechtsklick nicht kennt, findet sie sonst nicht.
  • Für eine Auswahl aus einer festen Liste nimm Select oder ein Menü an einer sichtbaren Schaltfläche.
  • Auf Touch-Geräten ist der Rechtsklick unüblich; dort braucht es eine sichtbare Alternative.
  • Für eine Rückfrage vor einer folgenreichen Aktion nimm den Bestätigungsdialog.

Aktionen an der Belegung

ContextMenu hält den Zustand, ContextMenuTrigger umschließt den Bereich, ContextMenuContent zeigt die Liste. ContextMenuItem ist ein Eintrag, ContextMenuLabel beschriftet ihn, ContextMenuSeparator trennt Gruppen.

Bett 12 · Station 3Belegt seit MontagRechtsklick für Aktionen
Beispiel und Quelltext
belegung.tsx
import {
  ContextMenu,
  ContextMenuContent,
  ContextMenuItem,
  ContextMenuLabel,
  ContextMenuSeparator,
  ContextMenuTrigger,
} from "@neodin-eu/ui";

function Belegung() {
  return (
    <ContextMenu>
      <ContextMenuTrigger asChild>
        <div
          tabIndex={0}
          className="flex w-72 flex-col gap-1 rounded-md border border-border bg-background p-4 text-sm"
        >
          <span className="font-semibold">Bett 12 · Station 3</span>
          <span className="text-muted-foreground">Belegt seit Montag</span>
          <span className="text-xs text-muted-foreground">Rechtsklick für Aktionen</span>
        </div>
      </ContextMenuTrigger>
      <ContextMenuContent aria-label="Aktionen für Bett 12">
        <ContextMenuLabel>Bett 12</ContextMenuLabel>
        <ContextMenuItem>Belegung bearbeiten</ContextMenuItem>
        <ContextMenuItem>Verlegung planen</ContextMenuItem>
        <ContextMenuSeparator />
        <ContextMenuItem variant="destructive">Bett freigeben</ContextMenuItem>
      </ContextMenuContent>
    </ContextMenu>
  );
}

Barrierefreiheit

  • Das Menü öffnet per Rechtsklick. Der Komponententest prüft außerdem die Tastatur: Die Kontextmenü-Taste und Umschalt+F10 lösen es ebenfalls aus.
  • Die geöffnete Liste hat die Rolle menu, jeder Eintrag die Rolle menuitem; der Test wählt einen Eintrag und prüft die Rückmeldung.
  • 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.
  • Der Auslöser ist mit tabIndex={0} erreichbar; ein bloßes div ohne Fokusmöglichkeit wäre für die Tastatur nicht bedienbar.

Props

Props von ContextMenu
PropTypStandardPflichtBeschreibung
onOpenChange((open: boolean) => void)–Nein–
openboolean–Nein–
Props von ContextMenuTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
Props von ContextMenuContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von ContextMenuItem
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