Komponenten
Menüleiste (Menubar)
StabilMehrere 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ü.
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.
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 Rollemenuitem. Der Komponententest öffnet „Datei“ über diese Rolle und prüftaria-expandedam Auslöser. ArrowDownöffnet das Menü,Escapeschließt es. Beides ist im Komponententest abgesichert.ArrowRightwechselt zum nächsten Menü der Leiste; der Test findet danach dessen Einträge.- Ein Untermenü öffnet
Enter; der Test prüftaria-expandedam Untermenü-Auslöser. - Die geöffnete Liste hat die Rolle
menu, ihre Einträge die Rollemenuitem. 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
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| defaultValue | string | – | Nein | – |
| onValueChange | ((value: string) => void) | – | Nein | – |
| value | string | – | 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. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |