Zum Inhalt springen
Dokumentation

Komponenten

Auswahl mit Suche (Combobox)

Stabil

Eine 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 Select direkter: 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

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

FrühschichtSpätschicht

2 von 4 Schichten gewählt.

Beispiel und Quelltext
schichten.tsx
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 combobox und meldet über aria-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 unten bewegt 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 emptyText lä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

Props von Combobox
PropTypStandardPflichtBeschreibung
classNamestring–NeinAdditional classes for the combobox container.
disabledboolean–NeinDisables the combobox trigger and option selection.
emptyTextstring–NeinEmpty state text; defaults to the `noResults` catalog entry.
idstring–NeinId assigned to the trigger button.
multipleboolean–NeinSelects 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)–NeinCalled with the newly selected value, or `null` when cleared. Called with the next array of selected values.
optionsComboboxOption[]–JaOptions shown in the dropdown and matched by the search input.
placeholderstring–NeinTrigger and search placeholder; defaults to the `selectOption` catalog entry.
valuestring | string[] | null–JaCurrently selected value, or `null` when nothing is selected. Currently selected values.

Siehe auch