Your next page is taking shape...

Opening Your Next Page…

Loading the guide and preparing its examples for you to explore. The page will appear here automatically when it’s ready, so you can keep this view open without refreshing.

Made for Preact. Built to be yours.

Forms & Input

Combobox

Searchable select built from `Popover` + `Command` — API shaped like the shadcn combobox docs, without `@base-ui/react`. Use composable primitives or the `ComboboxSelect` preset for `{ label, value }[]`. Make the expected input clear before someone interacts, and keep the current value, help text and validation feedback connected. Import it from @/components/kamod-ui/combobox.

Source · Design reference · API reference · Theming · Styles


Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Installation

Import combobox primitives (and optionally ComboboxSelect) from @/components/kamod-ui/combobox.

Install PackagesTerminal
pnpm add @kamod-ch/ui

Copy an example with @kamod-ch/ui or the matching @kamod-ch/ui/… subpath. The code block switches between those two installs. Connect The Global Theme CSS and Tailwind Source Detection before your first render.

Usage

Combobox supports single or multiple selection (value / onValueChange as string or string[]). liftedFilter shares the filter string between ComboboxInlineInput or ComboboxChipsInput and the list (Command stays mounted via forceMount on content). Set autoHighlight on the root (or ComboboxCommand) for first-match highlight plus ArrowUp/Down and Enter — works in ComboboxInput, ComboboxInlineInput, and ComboboxChipsInput via commandNavRef. showClear + ComboboxClear clears selection and filter. Multi-select: ComboboxChips + ComboboxChip + ComboboxChipsInput (implies liftedFilter). ComboboxSelect maps props to these patterns (liftedFilter, multiple, showClear, autoHighlight).

Import SetupTypeScript
import { Combobox } from "@kamod-ch/ui";

Choose a complete composition from the examples below; required child components and props vary by pattern.

Component Examples & Variants

Explore Combobox in Different Contexts, from the starting pattern to the compositions below. Begin with Basic, then compare the examples that match your content, state and layout. These are working patterns to adapt, not a list of interchangeable variant values: check the API Reference before using a prop or combining behaviors. Look at the surrounding labels, supporting text and spacing as well as the component itself.

Read the Result and Its Implementation Together. Use each showcase’s Code view to inspect imports and composition, or its Prompt view to prepare a setup or adaptation brief. Try the narrow preview and local theme controls before connecting real data, and use Reset to return an example to its initial state. Keep layout changes in class utilities where appropriate; follow the Component Styles Guide for hierarchy and the Theming Guide for shared surfaces and colors. The Accessibility Notes explain what to preserve when making those changes.

Basic

Use Search When the Choice List Needs It. Start with a string-based option list and an initial selection to understand the combobox's search-and-select flow. The trigger displays the chosen value, while the chevron indicates that more choices are available in the popup.

Keep the selected value recognizable after closing the panel and provide an empty-result message; a plain Select may be simpler for a very small list.

src/components/ComboboxExample.tsx1 line
// combobox-doc.tsx — ComboboxBasicPreview

Preset: ComboboxSelect

Keep Stored Values Separate from Display Labels. Use ComboboxSelect with options shaped as { label, value } when the standard selection layout fits your interface. It packages the common composition while keeping display labels separate from the values stored by the application.

Use those identifiers in application state, and check how the control behaves when an option disappears or its translated label changes after selection.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Controlled

Coordinate the Selection with the Rest of the Form. Pass value and handle onValueChange to keep the combobox selection in parent state. An active-row checkmark can reinforce that selection in the popup while the trigger shows the same current value.

Decide how clearing and unavailable values should be handled, especially when the option list is refreshed asynchronously.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Custom Row Content

Help Users Distinguish Similar Choices. Place ItemTitle and ItemDescription inside each ComboboxItem for options that need more context than a short label. The richer presentation helps distinguish similar choices without changing the value assigned to each option.

Keep each option's main label concise and avoid nesting unrelated interactive controls inside an option row.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Groups + Separator

Organize a Long List Around Recognizable Categories. Use ComboboxGroup to organize related choices and ComboboxSeparator to distinguish groups such as timezone regions. Grouping makes the option set easier to scan before or alongside filtering.

Keep search useful across groups and preserve clear separators; too many tiny categories can make a filtered list harder to scan than a flat set of choices.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Invalid

Explain the Missing or Unacceptable Selection. Apply aria-invalid to the combobox trigger when the selected value fails validation, and coordinate it with the surrounding field. A visible error should explain what choice is needed while the current value remains inspectable.

Associate a specific message with the control, keep its label visible, and decide whether the error should clear immediately on selection or after the next validation step.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Disabled

Make Unavailable Selection Understandable. Set disabled on Combobox to make its trigger unavailable as a whole. Keep the selected label visible so the form still communicates its current data even when that choice cannot presently be changed.

Explain prerequisites outside the disabled trigger, since users cannot rely on opening it for help. When a related field makes the choice available again, check whether the previous selection is still valid before retaining it.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Auto-Highlight + Keyboard

Distinguish the Highlighted Option from the Selected Value. Enable autoHighlight to highlight the first visible result after filtering. Arrow keys can move the highlighted row and Enter can activate it; highlighting is a navigation aid rather than a stored selection by itself.

Test filtering, arrow navigation and Enter together, and make sure an empty result never appears to have a valid highlighted choice.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Clear Button (Preset)

Define the Meaning of an Empty Value. Enable showClear on ComboboxSelect when choosing no value is a valid action. The clear control resets selection, and with a lifted filter it also clears the visible search text associated with that selection.

Keep the reset action accessible and distinguish optional selection from a required field that needs validation; inspect the filter state as well as the selected label after clearing.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Inline Input Trigger (Base UI Style)

Make the Editable Query Feel Like the Primary Control. Combine liftedFilter and autoHighlight when the visible field should act directly as the search input. Results open below it, reducing the steps between typing a query and selecting a matching option.

Explain whether the field accepts only listed values or arbitrary text, and keep query state distinct from the committed selection when the panel opens and closes.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width

Multi-Select + Chips

Keep a Growing Selection Manageable. Set multiple on ComboboxSelect to represent selected values as chips alongside ComboboxChipsInput. The onValueChange callback receives a string[], so the application can store the collection as one explicit field value.

Give removal actions useful names, handle duplicate values consistently, and test long labels and many selections so the field remains usable without horizontal overflow.

Interactive Live Preview
Try it. Make it yours.
Setting the scene...

Interactive preview

Live Preact example Local preview theme · Responsive styles follow the preview widthFull width
API reference

Props and Data

Configure Combobox using the contracts below. Read the documented options alongside the Source Definitions to understand which values your application supplies and which details the component owns. Start with a prop or helper, then follow its type link to inspect the declaration without leaving the page.

Props, slots and variants for this component.

API reference
Your API, from source

Type cards are extracted from this checkout’s TypeScript source at build time. Props inherited through HTMLAttributes, Omit or variant helpers remain references in those declarations; their fields are not flattened here. Match the reference to your installed version, and check a package’s exports before writing an import type. A type exported by a source file is not necessarily re-exported by @kamod-ch/ui.

Component Props

Read each option with its owning component. The
marker identifies required fields verified in that declaration. A ? means a field can be omitted; it does not promise a fallback value. Existing documented defaults remain alongside the descriptions. For callbacks, check the argument and return types before connecting your own state or services.
@kamod-ch/ui/combobox59.2 KB min · 13.1 KB gzipSignals: direct@preact/signals

Combobox

ComboboxProps

Combobox documented props
Prop / typeDescription
autoHighlight
booleanComboboxProps

Highlight first match and enable ArrowUp/Down + Enter in filter inputs (requires `ComboboxCommand autoHighlight` or preset).

Default
false
children
ComponentChild[] | ComponentChildComboboxProps

Configure children for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>ComboboxProps

Configure class for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
closeOnSelect
booleanComboboxProps

When `multiple`, defaults to `false`; when single, defaults to `true`.

Default
—
defaultOpen
booleanComboboxProps

Configure defaultOpen for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
defaultValue
string | string[]ComboboxProps

Configure defaultValue for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
disabled
booleanComboboxProps

Configure disabled for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
itemKey
((item: unknown) => string)ComboboxProps

Configure itemKey for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
items
readonly unknown[]ComboboxProps

Configure items for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
itemToStringValue
((item: unknown) => string)ComboboxProps

Configure itemToStringValue for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
liftedFilter
booleanComboboxProps

Share filter text between trigger input and `Command` (Base UI–style single input + list in popover).

Default
false
multiple
booleanComboboxProps

Configure multiple for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
onOpenChange
((open: boolean) => void)ComboboxProps

Configure onOpenChange for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onValueChange
((value: string | string[]) => void)ComboboxProps

Emits `string` when `multiple` is false, else `string[]`.

Default
—
open
booleanComboboxProps

Configure open for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
placeholder
stringComboboxProps

Configure placeholder for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
"Select…"
showClear
booleanComboboxProps

Configure showClear for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
value
string | string[]ComboboxProps

Configure value for Combobox. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxChip

ComboboxChipProps

ComboboxChip documented props
Prop / typeDescription
children
ComponentChild[] | ComponentChildComboboxChipProps

Configure children for ComboboxChip. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>ComboboxChipProps

Configure class for ComboboxChip. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
itemKey
stringComboboxChipProps

Configure itemKey for ComboboxChip. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxChips

ComboboxChipsProps

ComboboxChips documented props
Prop / typeDescription
children
ComponentChild[] | ComponentChildComboboxChipsProps

Configure children for ComboboxChips. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>ComboboxChipsProps

Configure class for ComboboxChips. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onClick
MouseEventHandler<HTMLDivElement>ComboboxChipsProps

Configure onClick for ComboboxChips. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxChipsInput

ComboboxChipsInputProps

ComboboxChipsInput documented props
Prop / typeDescription
class
string | SignalLike<string | undefined>ComboboxChipsInputProps

Configure class for ComboboxChipsInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onFocus
FocusEventHandler<HTMLInputElement>ComboboxChipsInputProps

Configure onFocus for ComboboxChipsInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onInput
InputEventHandler<HTMLInputElement>ComboboxChipsInputProps

Configure onInput for ComboboxChipsInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onKeyDown
KeyboardEventHandler<HTMLInputElement>ComboboxChipsInputProps

Configure onKeyDown for ComboboxChipsInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxClear

ComboboxClearProps

ComboboxClear documented props
Prop / typeDescription
class
string | SignalLike<string | undefined>ComboboxClearProps

Configure class for ComboboxClear. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onClick
MouseEventHandler<HTMLButtonElement>ComboboxClearProps

Configure onClick for ComboboxClear. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxCommand

CommandProps

ComboboxCommand documented props
Prop / typeDescription
autoHighlight
boolean

First visible item gets `data-highlighted`; enables ArrowUp/Down + Enter in `CommandInput`.

Default
—
children
ComponentChild[] | ComponentChild

Configure children for ComboboxCommand. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>

Configure class for ComboboxCommand. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
hasVisibleItems
Signal<boolean>

External visibility signal; updated by `CommandList` when provided.

Default
—
query
Signal<string>

External filter signal (e.g. combobox inline input shares query with the list).

Default
—

ComboboxContent

PopoverContentProps

ComboboxContent documented props
Prop / typeDescription
align
"start" | "center" | "end"

Configure align for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
children
ComponentChild[] | ComponentChild

Configure children for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>

Configure class for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
forceMount
boolean

Configure forceMount for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
side
"bottom" | "top" | "right" | "left"

Configure side for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
sideOffset
number

Configure sideOffset for ComboboxContent. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxEmpty

CommandEmptyProps

ComboboxEmpty documented props
Prop / typeDescription
children
ComponentChild[] | ComponentChild

Configure children for ComboboxEmpty. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>

Configure class for ComboboxEmpty. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxGroup

CommandGroupProps

ComboboxGroup documented props
Prop / typeDescription
children
ComponentChild[] | ComponentChild

Configure children for ComboboxGroup. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>

Configure class for ComboboxGroup. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
heading
string

Configure heading for ComboboxGroup. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxInlineInput

ComboboxInlineInputProps

ComboboxInlineInput documented props
Prop / typeDescription
class
string | SignalLike<string | undefined>ComboboxInlineInputProps

Configure class for ComboboxInlineInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onFocus
FocusEventHandler<HTMLInputElement>ComboboxInlineInputProps

Configure onFocus for ComboboxInlineInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onInput
InputEventHandler<HTMLInputElement>ComboboxInlineInputProps

Configure onInput for ComboboxInlineInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onKeyDown
KeyboardEventHandler<HTMLInputElement>ComboboxInlineInputProps

Configure onKeyDown for ComboboxInlineInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxInput

CommandInputProps

ComboboxInput documented props
Prop / typeDescription
class
string | SignalLike<string | undefined>

Configure class for ComboboxInput. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxItem

ComboboxItemProps

ComboboxItem documented props
Prop / typeDescription
children
ComponentChild[] | ComponentChildComboboxItemProps

Configure children for ComboboxItem. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>ComboboxItemProps

Configure class for ComboboxItem. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
disabled
boolean | SignalLike<boolean | undefined>ComboboxItemProps

Configure disabled for ComboboxItem. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
item
unknownComboboxItemProps

Configure item for ComboboxItem. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onClick
MouseEventHandler<HTMLButtonElement>ComboboxItemProps

Configure onClick for ComboboxItem. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxList

ComboboxListProps

ComboboxList documented props
Prop / typeDescription
children
ComponentChildren | ((item: unknown, index: number) => ComponentChildren)ComboboxListProps

Configure children for ComboboxList. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
items
readonly unknown[]ComboboxListProps

Configure items for ComboboxList. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onMount
((el: HTMLDivElement | null) => void)ComboboxListProps

Notified when the list root mounts (e.g. combobox inline input forwards keyboard to the list).

Default
—

ComboboxSelect

ComboboxSelectProps

ComboboxSelect documented props
Prop / typeDescription
autoHighlight
booleanComboboxSelectProps

Highlight first match and enable ArrowUp/Down + Enter in filter inputs (requires `ComboboxCommand autoHighlight` or preset).

Default
false
class
string | SignalLike<string | undefined>ComboboxSelectProps

Configure class for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
closeOnSelect
booleanComboboxSelectProps

When `multiple`, defaults to `false`; when single, defaults to `true`.

Default
—
defaultOpen
booleanComboboxSelectProps

Configure defaultOpen for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
defaultValue
string | string[]ComboboxSelectProps

Configure defaultValue for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
disabled
booleanComboboxSelectProps

Configure disabled for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
emptyText
stringComboboxSelectProps

Configure emptyText for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
"No results found."
liftedFilter
booleanComboboxSelectProps

Share filter text between trigger input and `Command` (Base UI–style single input + list in popover).

Default
false
multiple
booleanComboboxSelectProps

Configure multiple for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
onOpenChange
((open: boolean) => void)ComboboxSelectProps

Configure onOpenChange for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
onValueChange
((value: string | string[]) => void)ComboboxSelectProps

Emits `string` when `multiple` is false, else `string[]`.

Default
—
open
booleanComboboxSelectProps

Configure open for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
options
ComboboxOption[]ComboboxSelectProps

Configure options for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
placeholder
stringComboboxSelectProps

Configure placeholder for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
"Select…"
searchPlaceholder
stringComboboxSelectProps

Configure searchPlaceholder for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
"Search…"
showClear
booleanComboboxSelectProps

Configure showClear for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
false
triggerClass
stringComboboxSelectProps

Configure triggerClass for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
value
string | string[]ComboboxSelectProps

Configure value for ComboboxSelect. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxSeparator

CommandSeparatorProps

ComboboxSeparator documented props
Prop / typeDescription
class
string | SignalLike<string | undefined>

Configure class for ComboboxSeparator. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxTrigger

PopoverTriggerProps

ComboboxTrigger documented props
Prop / typeDescription
asChild
boolean

Configure asChild for ComboboxTrigger. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
children
ComponentChild[] | ComponentChild

Configure children for ComboboxTrigger. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>

Configure class for ComboboxTrigger. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
disabled
boolean | SignalLike<boolean | undefined>

Configure disabled for ComboboxTrigger. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

ComboboxValue

ComboboxValueProps

ComboboxValue documented props
Prop / typeDescription
children
ComponentChildren | ((state: { label: string; empty: boolean; keys: string[]; }) => ComponentChildren)ComboboxValueProps

Configure children for ComboboxValue. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
class
string | SignalLike<string | undefined>ComboboxValueProps

Configure class for ComboboxValue. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—
placeholder
stringComboboxValueProps

Configure placeholder for ComboboxValue. Compare its accepted type with the Usage Guidance before supplying a value.

Default
—

Data Type Reference

Expand a card to inspect and copy the exact declaration. The code header identifies its repository file; follow imported or inherited types in the Implementation Source when you need the complete dependency chain. Required-field summaries cover fields declared directly in that type. Source-only helpers and inferred schema outputs describe the local implementation, not additional props you can pass to every component.

ComboboxChip Props

2 declared fields
ComboboxChipProps
Exported Source Declaration from ComboboxChip.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxChipProps before adapting it.
Required fields
itemKey

ComboboxChips Props

1 declared field
ComboboxChipsProps
Exported Source Declaration from ComboboxChips.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxChipsProps before adapting it.
ComboboxChipsInputProps
Exported Source Declaration from ComboboxChipsInput.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxChipsInputProps before adapting it.

ComboboxClear Props

Declaration
ComboboxClearProps
Exported Source Declaration from ComboboxClear.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxClearProps before adapting it.
ComboboxInlineInputProps
Exported Source Declaration from ComboboxInlineInput.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxInlineInputProps before adapting it.

ComboboxItem Props

1 declared field
ComboboxItemProps
Exported Source Declaration from ComboboxItem.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxItemProps before adapting it.
Required fields
item

ComboboxList Props

2 declared fields
ComboboxListProps
Exported Source Declaration from ComboboxList.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxListProps before adapting it.
Required fields
children

ComboboxOption

2 declared fields
ComboboxOption
Exported Source Declaration from ComboboxSelect.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxOption before adapting it.
Required fields
label, value

ComboboxSelect Props

4 declared fields
ComboboxSelectProps
Exported Source Declaration from ComboboxSelect.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxSelectProps before adapting it.
Required fields
options

ComboboxValue Props

2 declared fields
ComboboxValueProps
Exported Source Declaration from ComboboxValue.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxValueProps before adapting it.

ComboboxCommandNav

2 declared fields
ComboboxCommandNav
Exported Source Declaration from combobox-context.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxCommandNav before adapting it.
Required fields
moveHighlight, activateHighlighted

ComboboxContextValue

22 declared fields
ComboboxContextValue
Exported Source Declaration from combobox-context.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxContextValue before adapting it.
Required fields
items, leafItems, itemToString, itemKey, selectedKeys, selectedKey, multiple, isSelected, selectByItem, toggleByItem, removeKey, clearSelection, placeholder, disabled, liftedFilter, filterQuery, hasVisibleItems, autoHighlight, showClear, closeOnSelect, comboboxListRef, commandNavRef

Combobox Props

17 declared fields
ComboboxProps
Exported Source Declaration from combobox-context.tsx. Referenced types retain their original names; inspect that file for imports and supporting definitions. Inspect the Complete Definition of ComboboxProps before adapting it.

Accessibility

Build the Complete Interaction, Including the Parts Outside Combobox. The notes below distinguish the current implementation from the labels, content and behavior your application supplies. Start with the Live Preview, check the Props and Data Reference, and test the finished composition with real content rather than assuming that an unchanged visual example covers every use case.

Built-in Behavior and Defaults

Combobox composes selection, search and popover/command pieces. Arrow highlighting is controlled by autoHighlight, which defaults to false in the convenience composition. Do not infer a complete ARIA combobox contract solely from the component name.

Labels and Relationships

Label the trigger and any separate search input according to their jobs. A filter placeholder is a hint, not a persistent label. Selected chips need identifiable removal actions; the default short Remove name may need extra context in a multi-selection interface.

Keyboard and Focus

With autoHighlight enabled, supported input handlers use Up/Down to move the highlight and Enter to activate it. Check the exact composition you use, including empty results, clearing, closing and focus return; visual highlighting alone does not guarantee that active results are announced.

States and Integration Details

Keep loading, no matches and no selection as separate states. Verify the rendered input/list relationship and screen-reader output before adopting the control for a critical workflow. Do not add combobox roles without the associated focus and state behavior.

Verify the Complete Interaction

Check Behavior as Well as Markup. Work through these scenarios in the application where the component will be used. Automated checks can help find structural problems; also review the reading experience with a screen reader, keyboard focus and the actual feedback from your application.

  1. Search with the keyboard, select a result, reopen and clear the selection without losing the field label.
  2. Remove a chip and verify focus goes to a surviving control with a meaningful name.
  3. Test no matches, asynchronous results and disabled choices with your target screen reader.

Recheck the result after changing Theme Tokens, translations or class overrides. Include text enlargement, narrow layouts and reduced-motion settings where animation is present. Inspect the Component Source when a behavior differs from your expectation; a role or state attribute does not implement keyboard interaction by itself.

For background, read the WAI-ARIA Authoring Guidance and Keyboard Interface Guidance. These explain the patterns; verify browser and assistive-technology behavior for the implementation and audience you actually support.

Take the Next Useful Step

You have the pieces. Put them into one real interaction, keep its state in one place, and check the result with the content your application will actually show.

Connect the Foundation

Return to Choose and Compose Components to connect this reference to a working screen. Keep global CSS in one entrypoint and import only the components that screen needs.

Build the Surrounding Screen

Find a neighboring interaction in the Component Library, or start with a complete Block. Replace sample content and destinations before refining the layout; a local class change can stay with the composition.

Make the Result Hold Up

Use shared theme roles for changes that belong everywhere. Then review the whole journey: keyboard focus, long labels, narrow screens and a clear way to recover when something fails.

Keep a link to the source and note your intentional changes. Your next edit should begin with a clear decision, not another search.