Zum Inhalt springen
Dokumentation

Komponenten

Menüleiste (Menubar)

Stabil

Mehrere Menüs nebeneinander wie in einer Anwendung – Datei, Ansicht, Station, mit Untermenüs und Zuständen.

Eine Menüleiste bündelt mehrere Menüs in einer Zeile, wie in einer Arbeitsanwendung: Datei, Ansicht, Station. Die Leiste bleibt sichtbar, die Menüs öffnen sich erst auf Klick oder mit der Tastatur.

Wann verwenden

  • Für eine dichte Arbeitsfläche, in der viele Befehle dauerhaft erreichbar sein sollen, etwa den Dienstplan.
  • Wenn sich Befehle in wenige Kategorien gliedern: Datei, Ansicht, Station.
  • Wenn Maus und Tastatur gemischt genutzt werden und die Befehle kurze Wege brauchen.

Wann nicht

  • Für die Hauptnavigation einer Anwendung ist das Navigationsmenü oder die Seitenleiste die richtige Wahl; die Menüleiste führt zu Befehlen.
  • Für eine einzelne Aktion genügt eine Schaltfläche oder ein Menü hinter einer Schaltfläche.
  • Auf schmalen Geräten fehlt der Platz für mehrere Menüs; dort passt ein Menü hinter einer Schaltfläche besser.
  • In einem Formular haben Menüs nichts verloren: Formulare arbeiten mit Feldern und einer klaren Hauptaktion.

Aufbau

Menubar ist die Leiste, MenubarMenu ein Menü darin, MenubarTrigger sein Auslöser. MenubarContent hält die Einträge (MenubarItem), MenubarSeparator trennt Gruppen, MenubarShortcut zeigt eine Tastenkombination. MenubarSub, MenubarSubTrigger und MenubarSubContent bilden ein Untermenü.

Beispiel und Quelltext
dienstplan.tsx
import {
  Menubar,
  MenubarContent,
  MenubarItem,
  MenubarMenu,
  MenubarSeparator,
  MenubarShortcut,
  MenubarSub,
  MenubarSubContent,
  MenubarSubTrigger,
  MenubarTrigger,
} from "@neodin-eu/ui";

function Dienstplan() {
  return (
    <Menubar aria-label="Dienstplan">
      <MenubarMenu>
        <MenubarTrigger>Datei</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>
            Neuer Dienstplan
            <MenubarShortcut>Strg N</MenubarShortcut>
          </MenubarItem>
          <MenubarItem>
            Dienstplan öffnen
            <MenubarShortcut>Strg O</MenubarShortcut>
          </MenubarItem>
          <MenubarSeparator />
          <MenubarSub>
            <MenubarSubTrigger>Exportieren</MenubarSubTrigger>
            <MenubarSubContent>
              <MenubarItem>Als PDF</MenubarItem>
              <MenubarItem>Als CSV</MenubarItem>
            </MenubarSubContent>
          </MenubarSub>
          <MenubarSeparator />
          <MenubarItem variant="destructive">Dienstplan verwerfen</MenubarItem>
        </MenubarContent>
      </MenubarMenu>
      <MenubarMenu>
        <MenubarTrigger>Station</MenubarTrigger>
        <MenubarContent>
          <MenubarItem>Station wechseln</MenubarItem>
          <MenubarItem>Übergabe starten</MenubarItem>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  );
}

Zustände und Auswahl

MenubarCheckboxItem schaltet einen Zustand ein und aus, etwa „Nur offene Dienste“. MenubarRadioGroup mit MenubarRadioItem wählt genau einen Wert, etwa den Zeitraum. MenubarLabel beschriftet eine Gruppe.

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

import {
  Menubar,
  MenubarCheckboxItem,
  MenubarContent,
  MenubarLabel,
  MenubarMenu,
  MenubarRadioGroup,
  MenubarRadioItem,
  MenubarSeparator,
  MenubarTrigger,
} from "@neodin-eu/ui";

function Ansicht() {
  const [nurOffene, setNurOffene] = React.useState(true);
  const [zeitraum, setZeitraum] = React.useState("woche");

  return (
    <Menubar aria-label="Ansicht des Dienstplans">
      <MenubarMenu>
        <MenubarTrigger>Ansicht</MenubarTrigger>
        <MenubarContent>
          <MenubarLabel>Schichten</MenubarLabel>
          <MenubarCheckboxItem
            checked={nurOffene}
            onCheckedChange={(value) => setNurOffene(value === true)}
          >
            Nur offene Dienste
          </MenubarCheckboxItem>
          <MenubarSeparator />
          <MenubarLabel>Zeitraum</MenubarLabel>
          <MenubarRadioGroup value={zeitraum} onValueChange={setZeitraum}>
            <MenubarRadioItem value="woche">Woche</MenubarRadioItem>
            <MenubarRadioItem value="monat">Monat</MenubarRadioItem>
          </MenubarRadioGroup>
        </MenubarContent>
      </MenubarMenu>
    </Menubar>
  );
}

Barrierefreiheit

  • Die Menüleiste trägt die Rolle menubar, ein Auslöser die Rolle menuitem. Der Komponententest öffnet „Datei“ über diese Rolle und prüft aria-expanded am Auslöser.
  • ArrowDown öffnet das Menü, Escape schließt es. Beides ist im Komponententest abgesichert.
  • ArrowRight wechselt zum nächsten Menü der Leiste; der Test findet danach dessen Einträge.
  • Ein Untermenü öffnet Enter; der Test prüft aria-expanded am Untermenü-Auslöser.
  • Die geöffnete Liste hat die Rolle menu, ihre Einträge die Rolle menuitem. Radix setzt den Fokus beim Schließen auf den Auslöser zurück.
  • Kontrollkästchen- und Options-Einträge melden ihren Zustand über aria-checked; das ist das Verhalten der Radix-Grundlage.
  • Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.

Props

Props von Menubar
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
defaultValuestring–Nein–
onValueChange((value: string) => void)–Nein–
valuestring–Nein–
Props von MenubarTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–
Props von MenubarContent
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
Props von MenubarItem
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.
Props von MenubarCheckboxItem
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch