Komponenten
Befehlspalette (Command)
StabilSuchen und handeln in einem Feld – Seiten, Stationen und Aktionen über die Tastatur erreichen.
Eine Befehlspalette verbindet Suche und Aktion in einem Feld: Tippen filtert
die Einträge, Enter führt den markierten Eintrag aus. Mit CommandDialog
liegt sie in einem Dialog und lässt sich über eine Tastenkombination öffnen.
Wann verwenden
- Für eine Suche über viele Seiten und Aktionen, die von überall erreichbar sein soll.
- Als Befehlsleiste für erfahrene Nutzer, etwa mit
Strg+Koder⌘+K. - Für eine Auswahl aus einer langen, durchsuchbaren Liste, etwa Stationen eines Hauses.
Wann nicht
- Für eine kurze Liste mit wenigen Einträgen genügt
Select. - Wenn die Auswahl immer sichtbar bleiben soll, passen
Tabsoder eine einfache Liste. - Für ein Formular mit mehreren Feldern ist ein Dialog mit Formular ruhiger; die Palette ist auf ein Suchfeld ausgelegt.
- Ohne Tastenkombination bleibt die Palette versteckt. Dann braucht es zusätzlich einen sichtbaren Einstieg.
Seiten und Aktionen
Command hält die Liste, CommandInput das Suchfeld, CommandList die
Ergebnisse. CommandGroup und CommandSeparator gliedern sie,
CommandEmpty zeigt den leeren Zustand und CommandShortcut die
Tastenkombination eines Eintrags.
import * as React from "react";
import {
Button,
CommandDialog,
CommandEmpty,
CommandGroup,
CommandInput,
CommandItem,
CommandList,
CommandSeparator,
CommandShortcut,
} from "@neodin-eu/ui";
function Suche() {
const [offen, setOffen] = React.useState(false);
return (
<>
<Button variant="outline" onClick={() => setOffen(true)}>
Befehlspalette öffnen
</Button>
<CommandDialog open={offen} onOpenChange={setOffen} shortcut="j">
<CommandInput placeholder="Seite oder Aktion suchen …" />
<CommandList>
<CommandEmpty>Keine Treffer</CommandEmpty>
<CommandGroup heading="Seiten">
<CommandItem value="dienstplan">Dienstplan</CommandItem>
<CommandItem value="stationen">Stationen</CommandItem>
<CommandItem value="tickets">Tickets</CommandItem>
</CommandGroup>
<CommandSeparator />
<CommandGroup heading="Aktionen">
<CommandItem value="drucken">
Dienstplan drucken
<CommandShortcut>⌘P</CommandShortcut>
</CommandItem>
<CommandItem value="wechseln">Station wechseln</CommandItem>
</CommandGroup>
</CommandList>
</CommandDialog>
</>
);
}Eigener Titel
CommandDialog nimmt einen title entgegen; er ist der zugängliche Name des
Dialogs. Ohne Angabe kommt der Text aus dem Sprachkatalog („Befehlspalette“).
Das Suchfeld bekommt seinen Platzhalter ebenfalls aus dem Katalog, sofern du
keinen eigenen setzt.
import * as React from "react";
import {
Button,
CommandDialog,
CommandEmpty,
CommandGroup,
CommandInput,
CommandItem,
CommandList,
} from "@neodin-eu/ui";
function Station() {
const [offen, setOffen] = React.useState(false);
return (
<>
<Button variant="secondary" onClick={() => setOffen(true)}>
Station wechseln
</Button>
<CommandDialog open={offen} onOpenChange={setOffen} title="Station wechseln">
<CommandInput placeholder="Station suchen …" />
<CommandList>
<CommandEmpty>Keine Station gefunden</CommandEmpty>
<CommandGroup heading="Haus A">
<CommandItem value="station 3">Station 3 · Innere Medizin</CommandItem>
<CommandItem value="station 4">Station 4 · Chirurgie</CommandItem>
</CommandGroup>
<CommandGroup heading="Haus B">
<CommandItem value="station 7">Station 7 · Geriatrie</CommandItem>
</CommandGroup>
</CommandList>
</CommandDialog>
</>
);
}Die Suche dieser Dokumentation ist selbst eine Befehlspalette: Der Knopf im
Kopfbereich öffnet CommandDialog mit shortcut="k", die Treffer kommen aus
einem eigenen Suchindex.
Barrierefreiheit
- Tippen filtert die Liste; im Komponententest bleibt nur der passende Eintrag übrig, der leere Zustand zeigt „Keine Treffer“ aus dem Katalog.
Pfeil nach untenbewegt die Markierung,Enterwählt den Eintrag – im Test übergetByRole("option")geprüft.CommandDialogöffnet mitStrg+Kund mit⌘+Kund schließt mitEscape; das ist im Komponententest abgesichert.- Der Dialog trägt den Titel aus
titlebeziehungsweise dem Katalog als zugänglichen Namen; der Test findet ihn übergetByRole("dialog", { name: "Befehlspalette" }). - Der offene Zustand ist im Komponententest in hell und dunkel geprüft. Für die Liste gilt dabei eine Ausnahme bei der Prüfregel für Pflichtkinder, weil cmdk die Optionen in eine zusätzliche Hülle legt.
- Eine Aktion, die nur über die Palette erreichbar ist, braucht zusätzlich einen sichtbaren Weg.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| onValueChange | ((value: string) => void) | – | Nein | Event handler called when the selected item of the menu changes. |
| value | string | – | Nein | Optional controlled state of the selected command menu item. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| shortcut | string | – | Nein | Single key that opens the palette while Ctrl/⌘ is held, e.g. `"k"`. |
| title | string | – | Nein | Accessible dialog title; defaults to the `commandPalette` catalog entry. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| onValueChange | ((search: string) => void) | – | Nein | Event handler called when the search value changes. |
| value | string | – | Nein | Optional controlled state for the value of the search input. |
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | Whether this item is currently disabled. |
| value | string | – | Nein | A unique value for this item. If no value is provided, it will be inferred from `children` or the rendered `textContent`. If your `textContent` changes between renders, you _must_ provide a stable, unique `value`. |