|Action Buttons that will render within the input.|
|Automatically focuses the input on render.|
|Disable the control. The browser defaults to false.|
|Sets DOM id for the control and associates label element via 'for' attribute. If an id is not pass, a random id will be generated for any render.|
|It is recommended to pass a simple string to offer guidance. Text will be styled based on status prop.|
|Pass a string or a fragment with an Icon and string.|
|Visually hides the label region.|
|Menu related props. @see MenuProps|
|Whether it is single selection or multi selection combobox.|
|Sets html name attribute for the underlying control. Useful for mapping to a data field.|
|Callback fired when the ComboBox looses focus within its containing element. This is not specific to the input element. Note, behavior will be enhanced in an upcoming release and the input will be the only focusable element.|
|Callback fired when the filtering input value changes.|
|Fired when user clicks on the Combobox input.|
|Fired when the user clicks on the dropdown icon to initiate opening the menu. If you want to offer default menu items without an input value, pass this function. This function can be an appropriate time to fetch menu item data. Remember to set the loading prop to true when when fetching data for an empty list.|
|Callback fired when the ComboBox input gains focus.|
|Makes the component non editable and non clickable. The browser defaults to false.|
|Indicate if the field is required. The browser defaults to false.|
|Currently selected option, single for single-select, an array for multi-select.|
|Set visual state based on a validation state.|
|Value of the combobox filtering input.|
|A visual which represents the selected item.|
The ComboBox component is a fully-featured dropdown Menu that manages state of selected items. If you only require users to select single options that render as plain text, we recommend using the Select component instead.
For more information on how to use the features and props for this component, check out the developer documentation.
The ComboBox component can be configured for one of two modes: single-select and multi-select. If the mode is set to multi-select, you can pass an object for selected props. By doing so, you can control which selected items should render as Selectable badges within the ComboBox input region.
The input region can also be used to filter results within the menu by utilizing the onChange callback function. The rendering of the Menu and its items will depend on the props passed to the ComboBox's menu prop. This component also allows for standard Form field structures such as being set required, disabled, or readOnly, as well as including a label, status, or info.