Komponenten
Auswahl (Select)
StabilGenau einen Wert aus einer festen Liste wählen – mit Gruppen und gesperrten Einträgen.
Eine Auswahl lässt genau einen Wert aus einer festen Liste wählen: eine Station, eine Schicht, eine Priorität. Die Liste bleibt geschlossen, damit keine Tippfehler entstehen.
Wann verwenden
- Für eine feste Liste mit mehr als vier Einträgen, etwa die Stationen eines Hauses.
- Wenn der gewählte Wert im Formular nur eine Zeile belegen soll.
- Wenn Einträge gesperrt sein müssen, etwa weil eine Schicht bereits ausgebucht ist.
Wann nicht
- Bei zwei bis vier Optionen ist eine Optionsgruppe besser: Alle Möglichkeiten bleiben sichtbar.
- Für mehrere Werte gleichzeitig nimm Kontrollkästchen.
- Für sehr lange Listen mit Suche passt
Comboboxbesser als eine lange Klappliste.
Aufbau
Select hält den Wert, SelectTrigger zeigt ihn an, SelectValue setzt den
Platzhalter, SelectContent und SelectItem bilden die Liste. Die
Beschriftung kommt von außen über Label und id.
Gewählt: Innere Medizin
import * as React from "react";
import {
Label,
Select,
SelectContent,
SelectItem,
SelectTrigger,
SelectValue,
} from "@neodin-eu/ui";
const stationen = [
{ value: "notaufnahme", label: "Notaufnahme" },
{ value: "innere", label: "Innere Medizin" },
{ value: "chirurgie", label: "Chirurgie" },
{ value: "intensiv", label: "Intensivstation" },
];
function Station() {
const [station, setStation] = React.useState("innere");
const gewaehlt = stationen.find((eintrag) => eintrag.value === station);
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label id="station-label" htmlFor="station">
Station
</Label>
<Select value={station} onValueChange={setStation}>
<SelectTrigger id="station" aria-labelledby="station-label" className="w-full">
<SelectValue placeholder="Station wählen" />
</SelectTrigger>
<SelectContent>
{stationen.map(({ value, label }) => (
<SelectItem key={value} value={value}>
{label}
</SelectItem>
))}
</SelectContent>
</Select>
<p className="text-xs text-muted-foreground">Gewählt: {gewaehlt?.label}</p>
</div>
);
}Gruppen und Zustände
SelectGroup und SelectLabel gliedern lange Listen, SelectSeparator trennt
sie sichtbar. Ein Eintrag mit disabled bleibt lesbar, ist aber nicht
auswählbar.
Gesperrte Einträge bleiben sichtbar.
import {
Label,
Select,
SelectContent,
SelectGroup,
SelectItem,
SelectLabel,
SelectSeparator,
SelectTrigger,
SelectValue,
} from "@neodin-eu/ui";
function Gruppe() {
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Label id="schicht-label" htmlFor="schicht">
Schicht
</Label>
<Select defaultValue="frueh">
<SelectTrigger id="schicht" aria-labelledby="schicht-label" className="w-full">
<SelectValue placeholder="Schicht wählen" />
</SelectTrigger>
<SelectContent>
<SelectGroup>
<SelectLabel>Tagschicht</SelectLabel>
<SelectItem value="frueh">Frühschicht (06:00–14:00)</SelectItem>
<SelectItem value="spaet">Spätschicht (14:00–22:00)</SelectItem>
</SelectGroup>
<SelectSeparator />
<SelectGroup>
<SelectLabel>Nachtschicht</SelectLabel>
<SelectItem value="nacht">Nachtschicht (22:00–06:00)</SelectItem>
<SelectItem value="bereitschaft" disabled>
Bereitschaft (nicht buchbar)
</SelectItem>
</SelectGroup>
</SelectContent>
</Select>
<p className="text-xs text-muted-foreground">Gesperrte Einträge bleiben sichtbar.</p>
</div>
);
}Barrierefreiheit
SelectTriggerrendert einbutton-Element mit der Rollecombobox. Der zugängliche Name kommt ausaria-labeloder einer verbundenen Beschriftung; im Komponententest wird die Auswahl übergetByRole("combobox", …)gefunden.Enteröffnet die Liste, die Pfeiltasten bewegen den Fokus zwischen den Einträgen,Enterübernimmt den markierten Eintrag. Das ist im Komponententest abgesichert.- Die geöffnete Liste hat die Rolle
listbox, jeder Eintrag die Rolleoption. Radix meldet den gewählten Eintrag als ausgewählt. - Der offene Zustand ist im Komponententest in hell und dunkel frei von axe-Verstößen.
- Ein gesperrter
SelectItemwird von der Tastatur übersprungen.
Props
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| defaultValue | string | – | Nein | – |
| disabled | boolean | – | Nein | – |
| onOpenChange | ((open: boolean) => void) | – | Nein | – |
| onValueChange | ((value: string) => void) | – | Nein | – |
| open | boolean | – | Nein | – |
| value | string | – | Nein | – |
Der Auslöser nimmt zusätzlich die Attribute eines nativen button-Elements
entgegen:
| Prop | Typ | Standard | Pflicht | Beschreibung |
|---|---|---|---|---|
| asChild | boolean | – | Nein | – |
| className | string | – | Nein | – |
| disabled | boolean | – | Nein | – |