Theme: ← Übersicht Tokens

Combobox (Select mit Suche)

Einzelauswahl mit Suchfilter und Options-Panel: Tastatur-Navigation (Pfeile/Enter), Escape/Außenklick schließen, optionale Beschreibungen pro Option

Components v1.0.0 Formulare WebsiteAppDesktop component.combobox

Nutzt: ui.icon

Beispiele

Einzelauswahl mit Suche und Beschreibungen (Pfeiltasten + Enter)
Zuständiges Team

Eigenschaften

PropTypDefaultBuilder-Label
labelstring""Label
placeholderstring"Auswählen …"Platzhalter
searchPlaceholderstring"Suchen …"Such-Platzhalter
options *array—Optionen

* Pflicht-Prop

Events & Slots

Events: ⚡ change — im Surface per on: {<event>: {action, params}} verdrahtbar.

Stellschrauben (Komponenten-Tokens)

Ebene 3 — aus dem CSS generiert (Registry). Umverdrahtbar per Hüllen-Komposition, ohne Markup-Eingriff; künftige Regler-Quelle des Component Builders.

TokenDefault
--combobox-action-primaryvar(--color-action-primary)
--combobox-border-defaultvar(--color-border-default)
--combobox-elevation-overlayvar(--elevation-overlay)
--combobox-focus-ring-colorvar(--focus-ring-color)
--combobox-focus-ring-offsetvar(--focus-ring-offset)
--combobox-focus-ring-widthvar(--focus-ring-width)
--combobox-form-backgroundvar(--form-background)
--combobox-form-bordervar(--form-border)
--combobox-form-border-hovervar(--form-border-hover)
--combobox-form-placeholdervar(--form-placeholder)
--combobox-radius-controlvar(--radius-control)
--combobox-radius-smvar(--radius-sm)
--combobox-surface-overlayvar(--color-surface-overlay)
--combobox-surface-sunkenvar(--color-surface-sunken)
--combobox-text-defaultvar(--color-text-default)
--combobox-text-mutedvar(--color-text-muted)

Genutzte Design-Tokens

border.hairlinecolor.action.primarycolor.border.defaultcolor.surface.overlaycolor.surface.sunkencolor.text.defaultcolor.text.mutedelevation.overlayfocus.ring-colorfocus.ring-offsetfocus.ring-widthfont.family.defaultform.backgroundform.borderform.border-hoverform.placeholderlayer.dropdownradius.controlradius.smsize.1size.2size.3size.32text.mdtext.smweight.medium

LLM-Notizen

component.combobox

Einzelauswahl mit Suchfilter. Ergänzung zu ui.select (kurze Listen) und component.multi-select (Mehrfachauswahl).

Wann nutzen

  • Listen ab ~8 Optionen oder wenn Optionen Beschreibungen brauchen.
  • Modell-/Team-/Kunden-Wahl in App-Fenstern.

Wichtige Props

  • options = [{label, description?, icon?, active?}] — genau ein active = Vorauswahl.
  • label, placeholder, searchPlaceholder.

Beispiel-Node


{"definition": "component.combobox", "props": {"label": "Modell", "options": [{"label": "Opus 4.8", "description": "stark, langsamer", "active": true}, {"label": "Haiku", "description": "schnell"}]}}

Hinweise

  • Tastatur: Pfeile navigieren, Enter wählt, Escape schließt. Emittiert change mit {value}.