Zum Inhalt springen
Dokumentation

Komponenten

Auswahl (Select)

Stabil

Genau 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 Combobox besser 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

Beispiel und Quelltext
station.tsx
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.

Beispiel und Quelltext
gruppe.tsx
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

  • SelectTrigger rendert ein button-Element mit der Rolle combobox. Der zugängliche Name kommt aus aria-label oder einer verbundenen Beschriftung; im Komponententest wird die Auswahl über getByRole("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 Rolle option. 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 SelectItem wird von der Tastatur übersprungen.

Props

Props von Select
PropTypStandardPflichtBeschreibung
defaultValuestring–Nein–
disabledboolean–Nein–
onOpenChange((open: boolean) => void)–Nein–
onValueChange((value: string) => void)–Nein–
openboolean–Nein–
valuestring–Nein–

Der Auslöser nimmt zusätzlich die Attribute eines nativen button-Elements entgegen:

Props von SelectTrigger
PropTypStandardPflichtBeschreibung
asChildboolean–Nein–
classNamestring–Nein–
disabledboolean–Nein–

Siehe auch