Combobox
Editable search with committed option identity.
Editable search with committed option identity.
Root.value is a selected item key. inputValue is independent editable text. Unmatched text is never silently accepted as an option.
The host owns the real single-line editor. Input retains focus during Arrow navigation; IME composition never selects. Filtering is case/diacritic insensitive over textValue and keywords. Empty reflects actual matches; disabled options cannot commit. open, value and inputValue are independently controlled with corresponding change requests. filter=false supports owner-filtered children. Duplicate-valued choices are rejected.
Parts: Root, Input, Content, Item, Empty, Trigger.
Draft source; shared Web A11y active-descendant projection, native/GPUI, compiler, consumer, visual and independent acceptance remain separate requirements.
Combobox is workspace source. There is no public proto-ui add target. Passing value, inputValue, or open selects controlled mode for that fact.
| Prop | Type | Default |
|---|---|---|
defaultValue | string | '' |
defaultInputValue | string | '' |
defaultOpen | boolean | false |
disabled | boolean | false |
readOnly | boolean | false |
filter | boolean | true |
loop | boolean | true |
a11yLabel | string | '' |
These props belong to Root. Input defaults placeholder, a11yLabel and name to ''. Content defaults side to bottom, align to start, sideOffset to 4 and collisionPadding to 8. Item defaults value, textValue and keywords to '' and disabled to false. Empty has no props. Trigger defaults disabled to false.