Komponenten
Auswahl mit Suche (Combobox)
StabilEine Auswahl durchsuchen und einen oder mehrere Werte wählen – ohne lange Liste.
Eine Combobox verbindet Auswahl und Suche: Du tippst einen Begriff, die Liste schrumpft auf passende Einträge, und ein Klick übernimmt den Wert. Das hilft überall dort, wo die Liste zu lang zum Scrollen ist – etwa bei Stationen, Kostenstellen oder Schichtarten.
Wann verwenden
- Wenn die Auswahl mehr als eine Handvoll Einträge hat und Nutzer den gesuchten Wert kennen, zum Beispiel eine Station im Dienstplan.
- Wenn einzelne Einträge vorübergehend gesperrt sind, aber sichtbar bleiben sollen.
- Wenn mehrere Werte gleichzeitig gelten und die gewählten Werte als Etiketten sichtbar bleiben sollen.
Wann nicht
- Für kurze, feste Listen mit drei bis fünf Einträgen ist
Selectdirekter: Alle Optionen stehen sofort offen. - Für freie Begriffe ohne feste Liste nimm
TagInput. - Wenn die Auswahl nur eine Nummer oder einen Text erwartet, genügt ein Eingabefeld.
Eine Auswahl
value hält den gewählten Wert als string oder null, onValueChange
liefert die Änderung. Die Suche im Popover filtert nach der Beschriftung; ein
gesperrter Eintrag bleibt sichtbar und ist als deaktiviert markiert.
Gewählt: Innere Medizin
import * as React from "react";
import { Combobox, Label } from "@neodin-eu/ui";
const stationen = [
{ value: "notaufnahme", label: "Notaufnahme" },
{ value: "innere", label: "Innere Medizin" },
{ value: "chirurgie", label: "Chirurgie" },
{ value: "intensiv", label: "Intensivstation" },
{ value: "kurzzeit", label: "Chirurgie (Kurzzeit)", disabled: true },
];
function Station() {
const [station, setStation] = React.useState<string | null>("innere");
const gewaehlt = stationen.find((eintrag) => eintrag.value === station);
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="combobox-station">Station</Label>
<Combobox
id="combobox-station"
options={stationen}
value={station}
placeholder="Station suchen"
onValueChange={setStation}
/>
<p className="text-xs text-muted-foreground">
{gewaehlt ? `Gewählt: ${gewaehlt.label}` : "Noch keine Station gewählt."}
</p>
</div>
);
}Mehrere Werte
Mit multiple wird value zur Liste. Jeder gewählte Wert erscheint als
Etikett im Feld und lässt sich über den Entfernen-Knopf oder erneut über die
Liste abwählen.
2 von 4 Schichten gewählt.
import * as React from "react";
import { Combobox, Label } from "@neodin-eu/ui";
const schichten = [
{ value: "frueh", label: "Frühschicht" },
{ value: "spaet", label: "Spätschicht" },
{ value: "nacht", label: "Nachtschicht" },
{ value: "bereitschaft", label: "Bereitschaft" },
];
function Schichten() {
const [gewaehlt, setGewaehlt] = React.useState<string[]>(["frueh", "spaet"]);
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label htmlFor="combobox-schichten">Schichten</Label>
<Combobox
id="combobox-schichten"
multiple
options={schichten}
value={gewaehlt}
placeholder="Schichten suchen"
onValueChange={setGewaehlt}
/>
<p className="text-xs text-muted-foreground">
{gewaehlt.length === 0
? "Noch keine Schicht gewählt."
: `${gewaehlt.length} von ${schichten.length} Schichten gewählt.`}
</p>
</div>
);
}Barrierefreiheit
- Die Schaltfläche trägt die Rolle
comboboxund meldet überaria-expanded, ob die Liste offen ist. Der Komponententest prüft beides. - Tippen im Suchfeld filtert die Optionen; die Trefferanzahl wird kleiner. Das ist im Komponententest abgesichert.
Pfeil nach untenbewegt die Auswahl durch die Liste,Enterübernimmt den hervorgehobenen Eintrag. Der Test prüft diese Tastaturbedienung.- Gesperrte Optionen tragen
aria-disabled="true"und lassen sich nicht auswählen. Sie bleiben in der Liste sichtbar. - Ohne Treffer erscheint „Keine Treffer“; über
emptyTextlässt sich der Text ersetzen. Beides prüft der Komponententest. - In der Mehrfachauswahl hat jedes Etikett einen Entfernen-Knopf mit eigenem Namen, zum Beispiel „Österreich entfernen“.
- Der Komponententest prüft die geöffnete Liste in hell und dunkel auf axe-Verstöße; eine bekannte Regel für die interne cmdk-Liste ist dabei ausgenommen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| className | string | – | Nein | Additional classes for the combobox container. |
| disabled | boolean | – | Nein | Disables the combobox trigger and option selection. |
| emptyText | string | – | Nein | Empty state text; defaults to the `noResults` catalog entry. |
| id | string | – | Nein | Id assigned to the trigger button. |
| multiple | boolean | – | Nein | Selects single-value mode; omitted or `false` for a single selection. Selects multi-value mode; `true` allows several selected values. |
| onValueChange | ((value: string | null) => void) | ((value: string[]) => void) | – | Nein | Called with the newly selected value, or `null` when cleared. Called with the next array of selected values. |
| options | ComboboxOption[] | – | Ja | Options shown in the dropdown and matched by the search input. |
| placeholder | string | – | Nein | Trigger and search placeholder; defaults to the `selectOption` catalog entry. |
| value | string | string[] | null | – | Ja | Currently selected value, or `null` when nothing is selected. Currently selected values. |