Combobox
Combobox<
T>(__namedParameters):Element
Defined in: src/components/controls/Combobox/Combobox.tsx:118
Single-value select with an editable input. Filters the option list as the
user types (built-in fuzzy matcher, configurable via filterFn), supports
controlled and uncontrolled modes, optional freeSolo typing, optional
creatable mode for adding new entries, and an loading state for async
data sources.
Type Parameters
Section titled “Type Parameters”T extends string = string
Parameters
Section titled “Parameters”__namedParameters
Section titled “__namedParameters”about?
Section titled “about?”string
accessKey?
Section titled “accessKey?”string
aria-activedescendant?
Section titled “aria-activedescendant?”string
Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application.
aria-atomic?
Section titled “aria-atomic?”Booleanish
Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.
aria-autocomplete?
Section titled “aria-autocomplete?”"none" | "inline" | "both" | "list"
Indicates whether inputting text could trigger display of one or more predictions of the user’s intended value for an input and specifies how predictions would be presented if they are made.
aria-braillelabel?
Section titled “aria-braillelabel?”string
Defines a string value that labels the current element, which is intended to be converted into Braille.
See
aria-label.
aria-brailleroledescription?
Section titled “aria-brailleroledescription?”string
Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille.
See
aria-roledescription.
aria-busy?
Section titled “aria-busy?”Booleanish
aria-checked?
Section titled “aria-checked?”boolean | "mixed" | "false" | "true"
Indicates the current “checked” state of checkboxes, radio buttons, and other widgets.
See
- aria-pressed
- aria-selected.
aria-colcount?
Section titled “aria-colcount?”number
Defines the total number of columns in a table, grid, or treegrid.
See
aria-colindex.
aria-colindex?
Section titled “aria-colindex?”number
Defines an element’s column index or position with respect to the total number of columns within a table, grid, or treegrid.
See
- aria-colcount
- aria-colspan.
aria-colindextext?
Section titled “aria-colindextext?”string
Defines a human readable text alternative of aria-colindex.
See
aria-rowindextext.
aria-colspan?
Section titled “aria-colspan?”number
Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.
See
- aria-colindex
- aria-rowspan.
aria-controls?
Section titled “aria-controls?”string
Identifies the element (or elements) whose contents or presence are controlled by the current element.
See
aria-owns.
aria-current?
Section titled “aria-current?”boolean | "location" | "page" | "false" | "true" | "step" | "date" | "time"
Indicates the element that represents the current item within a container or set of related elements.
aria-describedby?
Section titled “aria-describedby?”string
Identifies the element (or elements) that describes the object.
See
aria-labelledby
aria-description?
Section titled “aria-description?”string
Defines a string value that describes or annotates the current element.
See
related aria-describedby.
aria-details?
Section titled “aria-details?”string
Identifies the element that provides a detailed, extended description for the object.
See
aria-describedby.
aria-disabled?
Section titled “aria-disabled?”Booleanish
Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.
See
- aria-hidden
- aria-readonly.
aria-dropeffect?
Section titled “aria-dropeffect?”"none" | "link" | "copy" | "move" | "execute" | "popup"
Indicates what functions can be performed when a dragged object is released on the drop target.
aria-errormessage?
Section titled “aria-errormessage?”string
Identifies the element that provides an error message for the object.
See
- aria-invalid
- aria-describedby.
aria-expanded?
Section titled “aria-expanded?”Booleanish
Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.
aria-flowto?
Section titled “aria-flowto?”string
Identifies the next element (or elements) in an alternate reading order of content which, at the user’s discretion, allows assistive technology to override the general default of reading in document source order.
aria-grabbed?
Section titled “aria-grabbed?”Booleanish
Indicates an element’s “grabbed” state in a drag-and-drop operation.
aria-haspopup?
Section titled “aria-haspopup?”boolean | "grid" | "listbox" | "menu" | "false" | "true" | "dialog" | "tree"
Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element.
aria-hidden?
Section titled “aria-hidden?”Booleanish
Indicates whether the element is exposed to an accessibility API.
See
aria-disabled.
aria-invalid?
Section titled “aria-invalid?”boolean | "false" | "true" | "grammar" | "spelling"
Indicates the entered value does not conform to the format expected by the application.
See
aria-errormessage.
aria-keyshortcuts?
Section titled “aria-keyshortcuts?”string
Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element.
aria-label?
Section titled “aria-label?”string
Defines a string value that labels the current element.
See
aria-labelledby.
aria-labelledby?
Section titled “aria-labelledby?”string
Identifies the element (or elements) that labels the current element.
See
aria-describedby.
aria-level?
Section titled “aria-level?”number
Defines the hierarchical level of an element within a structure.
aria-live?
Section titled “aria-live?”"off" | "assertive" | "polite"
Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region.
aria-modal?
Section titled “aria-modal?”Booleanish
Indicates whether an element is modal when displayed.
aria-multiline?
Section titled “aria-multiline?”Booleanish
Indicates whether a text box accepts multiple lines of input or only a single line.
aria-multiselectable?
Section titled “aria-multiselectable?”Booleanish
Indicates that the user may select more than one item from the current selectable descendants.
aria-orientation?
Section titled “aria-orientation?”"horizontal" | "vertical"
Indicates whether the element’s orientation is horizontal, vertical, or unknown/ambiguous.
aria-owns?
Section titled “aria-owns?”string
Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship between DOM elements where the DOM hierarchy cannot be used to represent the relationship.
See
aria-controls.
aria-placeholder?
Section titled “aria-placeholder?”string
Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value. A hint could be a sample value or a brief description of the expected format.
aria-posinset?
Section titled “aria-posinset?”number
Defines an element’s number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
See
aria-setsize.
aria-pressed?
Section titled “aria-pressed?”boolean | "mixed" | "false" | "true"
Indicates the current “pressed” state of toggle buttons.
See
- aria-checked
- aria-selected.
aria-readonly?
Section titled “aria-readonly?”Booleanish
Indicates that the element is not editable, but is otherwise operable.
See
aria-disabled.
aria-relevant?
Section titled “aria-relevant?”"text" | "all" | "additions" | "additions removals" | "additions text" | "removals" | "removals additions" | "removals text" | "text additions" | "text removals"
Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.
See
aria-atomic.
aria-required?
Section titled “aria-required?”Booleanish
Indicates that user input is required on the element before a form may be submitted.
aria-roledescription?
Section titled “aria-roledescription?”string
Defines a human-readable, author-localized description for the role of an element.
aria-rowcount?
Section titled “aria-rowcount?”number
Defines the total number of rows in a table, grid, or treegrid.
See
aria-rowindex.
aria-rowindex?
Section titled “aria-rowindex?”number
Defines an element’s row index or position with respect to the total number of rows within a table, grid, or treegrid.
See
- aria-rowcount
- aria-rowspan.
aria-rowindextext?
Section titled “aria-rowindextext?”string
Defines a human readable text alternative of aria-rowindex.
See
aria-colindextext.
aria-rowspan?
Section titled “aria-rowspan?”number
Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.
See
- aria-rowindex
- aria-colspan.
aria-selected?
Section titled “aria-selected?”Booleanish
Indicates the current “selected” state of various widgets.
See
- aria-checked
- aria-pressed.
aria-setsize?
Section titled “aria-setsize?”number
Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
See
aria-posinset.
aria-sort?
Section titled “aria-sort?”"none" | "ascending" | "descending" | "other"
Indicates if items in a table or grid are sorted in ascending or descending order.
aria-valuemax?
Section titled “aria-valuemax?”number
Defines the maximum allowed value for a range widget.
aria-valuemin?
Section titled “aria-valuemin?”number
Defines the minimum allowed value for a range widget.
aria-valuenow?
Section titled “aria-valuenow?”number
Defines the current value for a range widget.
See
aria-valuetext.
aria-valuetext?
Section titled “aria-valuetext?”string
Defines the human readable text alternative of aria-valuenow for a range widget.
autoCapitalize?
Section titled “autoCapitalize?”"none" | string & object | "off" | "on" | "sentences" | "words" | "characters"
autoCorrect?
Section titled “autoCorrect?”string
autoFocus?
Section titled “autoFocus?”boolean
autoSave?
Section titled “autoSave?”string
className?
Section titled “className?”string
Additional CSS class names
clearable?
Section titled “clearable?”boolean = false
Show a clear button when a value is selected
color?
Section titled “color?”string
content?
Section titled “content?”string
contentEditable?
Section titled “contentEditable?”"inherit" | Booleanish | "plaintext-only"
contextMenu?
Section titled “contextMenu?”string
creatable?
Section titled “creatable?”boolean = false
When true the user can create a brand new option by pressing Enter on a
value that doesn’t match any existing option. The onCreate callback (or
onChange when omitted) is invoked. Implies freeSolo.
Default
falsecreateLabel?
Section titled “createLabel?”(query) => ReactNode
Render the “create” row when creatable is true and the query has no
exact match. Defaults to 'Create "<query>"'.
dangerouslySetInnerHTML?
Section titled “dangerouslySetInnerHTML?”{ __html: string | TrustedHTML; }
dangerouslySetInnerHTML.__html
Section titled “dangerouslySetInnerHTML.__html”string | TrustedHTML
datatype?
Section titled “datatype?”string
defaultChecked?
Section titled “defaultChecked?”boolean
defaultValue?
Section titled “defaultValue?”T
Default selected value (uncontrolled)
string
disabled?
Section titled “disabled?”boolean = false
Disable the input
draggable?
Section titled “draggable?”Booleanish
emptyMessage?
Section titled “emptyMessage?”string = 'No results found'
Message shown when filtering yields no results
enterKeyHint?
Section titled “enterKeyHint?”"search" | "next" | "enter" | "done" | "go" | "previous" | "send"
error?
Section titled “error?”boolean = false
Error state
errorMessage?
Section titled “errorMessage?”string
Error message — overrides helperText when error is true
exportparts?
Section titled “exportparts?”string
See
https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/exportparts
filterFn?
Section titled “filterFn?”(option, query) => number | boolean
Custom filter function. Receives the raw query and the option, returns
either a boolean (true to keep) or a numeric score (higher = better).
When omitted, options are filtered by the built-in fuzzy matcher
(fuzzyScore).
freeSolo?
Section titled “freeSolo?”boolean = false
Allow values not present in options. The onChange handler still fires
with the user-typed string when the input is blurred or Enter is pressed
with no active suggestion.
Default
falsehelperText?
Section titled “helperText?”string
Helper text rendered below
hidden?
Section titled “hidden?”boolean
string
Unique identifier for the component
inert?
Section titled “inert?”boolean
See
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/inert
inlist?
Section titled “inlist?”any
inputMode?
Section titled “inputMode?”"text" | "none" | "search" | "tel" | "url" | "email" | "numeric" | "decimal"
Hints at the type of data that might be entered by the user while editing the element or its contents
See
https://html.spec.whatwg.org/multipage/interaction.html#input-modalities:-the-inputmode-attribute
string
Specify that a standard HTML element should behave like a defined custom built-in element
See
https://html.spec.whatwg.org/multipage/custom-elements.html#attr-is
itemID?
Section titled “itemID?”string
itemProp?
Section titled “itemProp?”string
itemRef?
Section titled “itemRef?”string
itemScope?
Section titled “itemScope?”boolean
itemType?
Section titled “itemType?”string
label?
Section titled “label?”string
Label rendered above the input
string
loading?
Section titled “loading?”boolean = false
Loading indicator state — replaces options with a spinner row
loadingMessage?
Section titled “loadingMessage?”string = 'Loading...'
Message shown while loading
maxDropdownHeight?
Section titled “maxDropdownHeight?”number = 240
Maximum dropdown height in pixels
minDropdownWidth?
Section titled “minDropdownWidth?”number
Minimum dropdown width in pixels
string
Hidden form-input name
nonce?
Section titled “nonce?”string
onAbort?
Section titled “onAbort?”ReactEventHandler<HTMLInputElement>
onAbortCapture?
Section titled “onAbortCapture?”ReactEventHandler<HTMLInputElement>
onAnimationEnd?
Section titled “onAnimationEnd?”AnimationEventHandler<HTMLInputElement>
onAnimationEndCapture?
Section titled “onAnimationEndCapture?”AnimationEventHandler<HTMLInputElement>
onAnimationIteration?
Section titled “onAnimationIteration?”AnimationEventHandler<HTMLInputElement>
onAnimationIterationCapture?
Section titled “onAnimationIterationCapture?”AnimationEventHandler<HTMLInputElement>
onAnimationStart?
Section titled “onAnimationStart?”AnimationEventHandler<HTMLInputElement>
onAnimationStartCapture?
Section titled “onAnimationStartCapture?”AnimationEventHandler<HTMLInputElement>
onAuxClick?
Section titled “onAuxClick?”MouseEventHandler<HTMLInputElement>
onAuxClickCapture?
Section titled “onAuxClickCapture?”MouseEventHandler<HTMLInputElement>
onBeforeInput?
Section titled “onBeforeInput?”InputEventHandler<HTMLInputElement>
onBeforeInputCapture?
Section titled “onBeforeInputCapture?”InputEventHandler<HTMLInputElement>
onBeforeToggle?
Section titled “onBeforeToggle?”ToggleEventHandler<HTMLInputElement>
onBlur?
Section titled “onBlur?”FocusEventHandler<HTMLInputElement>
onBlurCapture?
Section titled “onBlurCapture?”FocusEventHandler<HTMLInputElement>
onCanPlay?
Section titled “onCanPlay?”ReactEventHandler<HTMLInputElement>
onCanPlayCapture?
Section titled “onCanPlayCapture?”ReactEventHandler<HTMLInputElement>
onCanPlayThrough?
Section titled “onCanPlayThrough?”ReactEventHandler<HTMLInputElement>
onCanPlayThroughCapture?
Section titled “onCanPlayThroughCapture?”ReactEventHandler<HTMLInputElement>
onChange?
Section titled “onChange?”(value) => void
Selection change handler. null is passed when the value is cleared.
onChangeCapture?
Section titled “onChangeCapture?”ChangeEventHandler<HTMLInputElement, Element>
onClick?
Section titled “onClick?”MouseEventHandler<HTMLInputElement>
onClickCapture?
Section titled “onClickCapture?”MouseEventHandler<HTMLInputElement>
onCompositionEnd?
Section titled “onCompositionEnd?”CompositionEventHandler<HTMLInputElement>
onCompositionEndCapture?
Section titled “onCompositionEndCapture?”CompositionEventHandler<HTMLInputElement>
onCompositionStart?
Section titled “onCompositionStart?”CompositionEventHandler<HTMLInputElement>
onCompositionStartCapture?
Section titled “onCompositionStartCapture?”CompositionEventHandler<HTMLInputElement>
onCompositionUpdate?
Section titled “onCompositionUpdate?”CompositionEventHandler<HTMLInputElement>
onCompositionUpdateCapture?
Section titled “onCompositionUpdateCapture?”CompositionEventHandler<HTMLInputElement>
onContextMenu?
Section titled “onContextMenu?”MouseEventHandler<HTMLInputElement>
onContextMenuCapture?
Section titled “onContextMenuCapture?”MouseEventHandler<HTMLInputElement>
onCopy?
Section titled “onCopy?”ClipboardEventHandler<HTMLInputElement>
onCopyCapture?
Section titled “onCopyCapture?”ClipboardEventHandler<HTMLInputElement>
onCreate?
Section titled “onCreate?”(input) => void
Called when the user creates a new option (only when creatable is set).
Falls back to onChange with the typed string cast as T when omitted.
onCut?
Section titled “onCut?”ClipboardEventHandler<HTMLInputElement>
onCutCapture?
Section titled “onCutCapture?”ClipboardEventHandler<HTMLInputElement>
onDoubleClick?
Section titled “onDoubleClick?”MouseEventHandler<HTMLInputElement>
onDoubleClickCapture?
Section titled “onDoubleClickCapture?”MouseEventHandler<HTMLInputElement>
onDrag?
Section titled “onDrag?”DragEventHandler<HTMLInputElement>
onDragCapture?
Section titled “onDragCapture?”DragEventHandler<HTMLInputElement>
onDragEnd?
Section titled “onDragEnd?”DragEventHandler<HTMLInputElement>
onDragEndCapture?
Section titled “onDragEndCapture?”DragEventHandler<HTMLInputElement>
onDragEnter?
Section titled “onDragEnter?”DragEventHandler<HTMLInputElement>
onDragEnterCapture?
Section titled “onDragEnterCapture?”DragEventHandler<HTMLInputElement>
onDragExit?
Section titled “onDragExit?”DragEventHandler<HTMLInputElement>
onDragExitCapture?
Section titled “onDragExitCapture?”DragEventHandler<HTMLInputElement>
onDragLeave?
Section titled “onDragLeave?”DragEventHandler<HTMLInputElement>
onDragLeaveCapture?
Section titled “onDragLeaveCapture?”DragEventHandler<HTMLInputElement>
onDragOver?
Section titled “onDragOver?”DragEventHandler<HTMLInputElement>
onDragOverCapture?
Section titled “onDragOverCapture?”DragEventHandler<HTMLInputElement>
onDragStart?
Section titled “onDragStart?”DragEventHandler<HTMLInputElement>
onDragStartCapture?
Section titled “onDragStartCapture?”DragEventHandler<HTMLInputElement>
onDrop?
Section titled “onDrop?”DragEventHandler<HTMLInputElement>
onDropCapture?
Section titled “onDropCapture?”DragEventHandler<HTMLInputElement>
onDurationChange?
Section titled “onDurationChange?”ReactEventHandler<HTMLInputElement>
onDurationChangeCapture?
Section titled “onDurationChangeCapture?”ReactEventHandler<HTMLInputElement>
onEmptied?
Section titled “onEmptied?”ReactEventHandler<HTMLInputElement>
onEmptiedCapture?
Section titled “onEmptiedCapture?”ReactEventHandler<HTMLInputElement>
onEncrypted?
Section titled “onEncrypted?”ReactEventHandler<HTMLInputElement>
onEncryptedCapture?
Section titled “onEncryptedCapture?”ReactEventHandler<HTMLInputElement>
onEnded?
Section titled “onEnded?”ReactEventHandler<HTMLInputElement>
onEndedCapture?
Section titled “onEndedCapture?”ReactEventHandler<HTMLInputElement>
onError?
Section titled “onError?”ReactEventHandler<HTMLInputElement>
onErrorCapture?
Section titled “onErrorCapture?”ReactEventHandler<HTMLInputElement>
onFocus?
Section titled “onFocus?”FocusEventHandler<HTMLInputElement>
onFocusCapture?
Section titled “onFocusCapture?”FocusEventHandler<HTMLInputElement>
onGotPointerCapture?
Section titled “onGotPointerCapture?”PointerEventHandler<HTMLInputElement>
onGotPointerCaptureCapture?
Section titled “onGotPointerCaptureCapture?”PointerEventHandler<HTMLInputElement>
onInput?
Section titled “onInput?”InputEventHandler<HTMLInputElement>
onInputCapture?
Section titled “onInputCapture?”InputEventHandler<HTMLInputElement>
onInputChange?
Section titled “onInputChange?”(input) => void
Free-text change handler. Fires every keystroke regardless of selection status. Useful for async option loading.
onInvalid?
Section titled “onInvalid?”ReactEventHandler<HTMLInputElement>
onInvalidCapture?
Section titled “onInvalidCapture?”ReactEventHandler<HTMLInputElement>
onKeyDown?
Section titled “onKeyDown?”KeyboardEventHandler<HTMLInputElement>
onKeyDownCapture?
Section titled “onKeyDownCapture?”KeyboardEventHandler<HTMLInputElement>
onKeyPress?
Section titled “onKeyPress?”KeyboardEventHandler<HTMLInputElement>
onKeyPressCapture?
Section titled “onKeyPressCapture?”KeyboardEventHandler<HTMLInputElement>
onKeyUp?
Section titled “onKeyUp?”KeyboardEventHandler<HTMLInputElement>
onKeyUpCapture?
Section titled “onKeyUpCapture?”KeyboardEventHandler<HTMLInputElement>
onLoad?
Section titled “onLoad?”ReactEventHandler<HTMLInputElement>
onLoadCapture?
Section titled “onLoadCapture?”ReactEventHandler<HTMLInputElement>
onLoadedData?
Section titled “onLoadedData?”ReactEventHandler<HTMLInputElement>
onLoadedDataCapture?
Section titled “onLoadedDataCapture?”ReactEventHandler<HTMLInputElement>
onLoadedMetadata?
Section titled “onLoadedMetadata?”ReactEventHandler<HTMLInputElement>
onLoadedMetadataCapture?
Section titled “onLoadedMetadataCapture?”ReactEventHandler<HTMLInputElement>
onLoadStart?
Section titled “onLoadStart?”ReactEventHandler<HTMLInputElement>
onLoadStartCapture?
Section titled “onLoadStartCapture?”ReactEventHandler<HTMLInputElement>
onLostPointerCapture?
Section titled “onLostPointerCapture?”PointerEventHandler<HTMLInputElement>
onLostPointerCaptureCapture?
Section titled “onLostPointerCaptureCapture?”PointerEventHandler<HTMLInputElement>
onMouseDown?
Section titled “onMouseDown?”MouseEventHandler<HTMLInputElement>
onMouseDownCapture?
Section titled “onMouseDownCapture?”MouseEventHandler<HTMLInputElement>
onMouseEnter?
Section titled “onMouseEnter?”MouseEventHandler<HTMLInputElement>
onMouseLeave?
Section titled “onMouseLeave?”MouseEventHandler<HTMLInputElement>
onMouseMove?
Section titled “onMouseMove?”MouseEventHandler<HTMLInputElement>
onMouseMoveCapture?
Section titled “onMouseMoveCapture?”MouseEventHandler<HTMLInputElement>
onMouseOut?
Section titled “onMouseOut?”MouseEventHandler<HTMLInputElement>
onMouseOutCapture?
Section titled “onMouseOutCapture?”MouseEventHandler<HTMLInputElement>
onMouseOver?
Section titled “onMouseOver?”MouseEventHandler<HTMLInputElement>
onMouseOverCapture?
Section titled “onMouseOverCapture?”MouseEventHandler<HTMLInputElement>
onMouseUp?
Section titled “onMouseUp?”MouseEventHandler<HTMLInputElement>
onMouseUpCapture?
Section titled “onMouseUpCapture?”MouseEventHandler<HTMLInputElement>
onOpenChange?
Section titled “onOpenChange?”(open) => void
Open state change handler
onPaste?
Section titled “onPaste?”ClipboardEventHandler<HTMLInputElement>
onPasteCapture?
Section titled “onPasteCapture?”ClipboardEventHandler<HTMLInputElement>
onPause?
Section titled “onPause?”ReactEventHandler<HTMLInputElement>
onPauseCapture?
Section titled “onPauseCapture?”ReactEventHandler<HTMLInputElement>
onPlay?
Section titled “onPlay?”ReactEventHandler<HTMLInputElement>
onPlayCapture?
Section titled “onPlayCapture?”ReactEventHandler<HTMLInputElement>
onPlaying?
Section titled “onPlaying?”ReactEventHandler<HTMLInputElement>
onPlayingCapture?
Section titled “onPlayingCapture?”ReactEventHandler<HTMLInputElement>
onPointerCancel?
Section titled “onPointerCancel?”PointerEventHandler<HTMLInputElement>
onPointerCancelCapture?
Section titled “onPointerCancelCapture?”PointerEventHandler<HTMLInputElement>
onPointerDown?
Section titled “onPointerDown?”PointerEventHandler<HTMLInputElement>
onPointerDownCapture?
Section titled “onPointerDownCapture?”PointerEventHandler<HTMLInputElement>
onPointerEnter?
Section titled “onPointerEnter?”PointerEventHandler<HTMLInputElement>
onPointerLeave?
Section titled “onPointerLeave?”PointerEventHandler<HTMLInputElement>
onPointerMove?
Section titled “onPointerMove?”PointerEventHandler<HTMLInputElement>
onPointerMoveCapture?
Section titled “onPointerMoveCapture?”PointerEventHandler<HTMLInputElement>
onPointerOut?
Section titled “onPointerOut?”PointerEventHandler<HTMLInputElement>
onPointerOutCapture?
Section titled “onPointerOutCapture?”PointerEventHandler<HTMLInputElement>
onPointerOver?
Section titled “onPointerOver?”PointerEventHandler<HTMLInputElement>
onPointerOverCapture?
Section titled “onPointerOverCapture?”PointerEventHandler<HTMLInputElement>
onPointerUp?
Section titled “onPointerUp?”PointerEventHandler<HTMLInputElement>
onPointerUpCapture?
Section titled “onPointerUpCapture?”PointerEventHandler<HTMLInputElement>
onProgress?
Section titled “onProgress?”ReactEventHandler<HTMLInputElement>
onProgressCapture?
Section titled “onProgressCapture?”ReactEventHandler<HTMLInputElement>
onRateChange?
Section titled “onRateChange?”ReactEventHandler<HTMLInputElement>
onRateChangeCapture?
Section titled “onRateChangeCapture?”ReactEventHandler<HTMLInputElement>
onReset?
Section titled “onReset?”ReactEventHandler<HTMLInputElement>
onResetCapture?
Section titled “onResetCapture?”ReactEventHandler<HTMLInputElement>
onScroll?
Section titled “onScroll?”UIEventHandler<HTMLInputElement>
onScrollCapture?
Section titled “onScrollCapture?”UIEventHandler<HTMLInputElement>
onScrollEnd?
Section titled “onScrollEnd?”UIEventHandler<HTMLInputElement>
onScrollEndCapture?
Section titled “onScrollEndCapture?”UIEventHandler<HTMLInputElement>
onSeeked?
Section titled “onSeeked?”ReactEventHandler<HTMLInputElement>
onSeekedCapture?
Section titled “onSeekedCapture?”ReactEventHandler<HTMLInputElement>
onSeeking?
Section titled “onSeeking?”ReactEventHandler<HTMLInputElement>
onSeekingCapture?
Section titled “onSeekingCapture?”ReactEventHandler<HTMLInputElement>
onSelect?
Section titled “onSelect?”ReactEventHandler<HTMLInputElement>
onSelectCapture?
Section titled “onSelectCapture?”ReactEventHandler<HTMLInputElement>
onStalled?
Section titled “onStalled?”ReactEventHandler<HTMLInputElement>
onStalledCapture?
Section titled “onStalledCapture?”ReactEventHandler<HTMLInputElement>
onSubmit?
Section titled “onSubmit?”SubmitEventHandler<HTMLInputElement>
onSubmitCapture?
Section titled “onSubmitCapture?”SubmitEventHandler<HTMLInputElement>
onSuspend?
Section titled “onSuspend?”ReactEventHandler<HTMLInputElement>
onSuspendCapture?
Section titled “onSuspendCapture?”ReactEventHandler<HTMLInputElement>
onTimeUpdate?
Section titled “onTimeUpdate?”ReactEventHandler<HTMLInputElement>
onTimeUpdateCapture?
Section titled “onTimeUpdateCapture?”ReactEventHandler<HTMLInputElement>
onToggle?
Section titled “onToggle?”ToggleEventHandler<HTMLInputElement>
onTouchCancel?
Section titled “onTouchCancel?”TouchEventHandler<HTMLInputElement>
onTouchCancelCapture?
Section titled “onTouchCancelCapture?”TouchEventHandler<HTMLInputElement>
onTouchEnd?
Section titled “onTouchEnd?”TouchEventHandler<HTMLInputElement>
onTouchEndCapture?
Section titled “onTouchEndCapture?”TouchEventHandler<HTMLInputElement>
onTouchMove?
Section titled “onTouchMove?”TouchEventHandler<HTMLInputElement>
onTouchMoveCapture?
Section titled “onTouchMoveCapture?”TouchEventHandler<HTMLInputElement>
onTouchStart?
Section titled “onTouchStart?”TouchEventHandler<HTMLInputElement>
onTouchStartCapture?
Section titled “onTouchStartCapture?”TouchEventHandler<HTMLInputElement>
onTransitionCancel?
Section titled “onTransitionCancel?”TransitionEventHandler<HTMLInputElement>
onTransitionCancelCapture?
Section titled “onTransitionCancelCapture?”TransitionEventHandler<HTMLInputElement>
onTransitionEnd?
Section titled “onTransitionEnd?”TransitionEventHandler<HTMLInputElement>
onTransitionEndCapture?
Section titled “onTransitionEndCapture?”TransitionEventHandler<HTMLInputElement>
onTransitionRun?
Section titled “onTransitionRun?”TransitionEventHandler<HTMLInputElement>
onTransitionRunCapture?
Section titled “onTransitionRunCapture?”TransitionEventHandler<HTMLInputElement>
onTransitionStart?
Section titled “onTransitionStart?”TransitionEventHandler<HTMLInputElement>
onTransitionStartCapture?
Section titled “onTransitionStartCapture?”TransitionEventHandler<HTMLInputElement>
onVolumeChange?
Section titled “onVolumeChange?”ReactEventHandler<HTMLInputElement>
onVolumeChangeCapture?
Section titled “onVolumeChangeCapture?”ReactEventHandler<HTMLInputElement>
onWaiting?
Section titled “onWaiting?”ReactEventHandler<HTMLInputElement>
onWaitingCapture?
Section titled “onWaitingCapture?”ReactEventHandler<HTMLInputElement>
onWheel?
Section titled “onWheel?”WheelEventHandler<HTMLInputElement>
onWheelCapture?
Section titled “onWheelCapture?”WheelEventHandler<HTMLInputElement>
openOnFocus?
Section titled “openOnFocus?”boolean = false
Open the dropdown automatically when the input gains focus, even when no query is typed yet.
Default
falseoptions
Section titled “options”ComboboxOption<T>[]
Available options
string
See
https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/part
placeholder?
Section titled “placeholder?”string
Placeholder rendered when the input is empty
popover?
Section titled “popover?”"" | "auto" | "manual" | "hint"
popoverTarget?
Section titled “popoverTarget?”string
popoverTargetAction?
Section titled “popoverTargetAction?”"toggle" | "hide" | "show"
prefix?
Section titled “prefix?”string
property?
Section titled “property?”string
radioGroup?
Section titled “radioGroup?”string
readOnly?
Section titled “readOnly?”boolean = false
Read-only — input value is fixed
Ref<HTMLInputElement>
string
required?
Section titled “required?”boolean = false
Mark the field as required
resource?
Section titled “resource?”string
results?
Section titled “results?”number
string
AriaRole
security?
Section titled “security?”string
Size = 'md'
Component size
string
spellCheck?
Section titled “spellCheck?”Booleanish
style?
Section titled “style?”CSSProperties
Custom inline styles
suppressContentEditableWarning?
Section titled “suppressContentEditableWarning?”boolean
suppressHydrationWarning?
Section titled “suppressHydrationWarning?”boolean
tabIndex?
Section titled “tabIndex?”number
testId?
Section titled “testId?”string
Test identifier for automated testing
title?
Section titled “title?”string
translate?
Section titled “translate?”"yes" | "no"
typeof?
Section titled “typeof?”string
unselectable?
Section titled “unselectable?”"off" | "on"
value?
Section titled “value?”T | null
Controlled selected value
variant?
Section titled “variant?”ComboboxVariant = 'default'
Visual variant
vocab?
Section titled “vocab?”string
Returns
Section titled “Returns”Element
Example
Section titled “Example”<Combobox label="Framework" options={[ { value: 'react', label: 'React' }, { value: 'vue', label: 'Vue' }, ]} value={framework} onChange={setFramework}/>