Combobox 1.2.0
Die <velin-combobox>-Komponente kombiniert ein Textfeld und eine filterbare Listbox. Platziere die Eingabe im trigger-Slot; Optionen verwenden role="option". Hinzugefuegt in 0.7.5. English: Combobox
Reifegrad: In VelinStyle 1.2.0 als stabil dokumentiert. Design Intelligence (Plan / Review / Agent-Meta) ist separat und, wo angegeben, Beta / Grundlage.
Wann verwenden
- Filterable single-select fields with
<velin-combobox>when users type to narrow options. - Form inputs that need a listbox popup instead of a native
<select>.
Wann nicht verwenden
- Aktionsmenues ohne Wertefeld: verwende Dropdown.
- Global command search — use Command palette.
Discovery: Prefer
<velin-combobox> over inventing a filterable select.
Put the text field in slot="trigger"; options are role="option" buttons.
See also forms overview and generated API.
Beispiel
<velin-combobox aria-label="Fruit picker">
<input slot="trigger" class="velin-input" aria-label="Fruit" />
<button type="button" role="option">Apple</button>
</velin-combobox>
Ereignisse
| Event | Detail |
|---|---|
velin-select | { option } |
Import
Lade das Bundle einmal und nutze dann das Custom Element in deinem Markup:
<script type="module" src="../../dist/velinstyle-components.min.js"></script>
<velin-combobox>…</velin-combobox>
Barrierefreiheit
- Verdrahte Textfeld und Listbox wie in den Beispielen, damit Tastaturnutzer Optionen oeffnen, filtern und auswaehlen koennen.
- Zeige den ausgewaehlten Wert im Feld; halte Optionstexte lesbar (nicht nur Icons).