Combobox
Editable search with committed option identity.
Ordinary demos on this page explicitly use Shadcn Rhea, with matching examples. This does not change public compatibility defaults or imply complete browser, native-host or visual acceptance. Neutral Surface/Text atoms retain their own public semantics; the consumer composition supplies the family presentation theme.
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. It reuses the shared search-family props. defaultOpen is false.
| 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 to side="bottom", align="start", sideOffset 4, and collisionPadding 8. Item defaults value, textValue, and keywords to '', and disabled to false. Trigger defaults disabled to false.