Props

A function used to determine if two options' values are equal. By default, reference equality is used.

There is a performance impact when using the areOptionsEqual prop (proportional to the number of options). Therefore, it's recommented to use the default reference equality comparison whenever possible.

This prop helps users to fill forms faster, especially on mobile devices. The name can be confusing, as it's more like an autofill. You can learn more about it following the specification.

If true, the select element is focused during the first mount

If true, the select will be initially open.

The default selected value. Use when the component is not controlled.

If true, the select is disabled.

A function used to convert the option label to a string. It's useful when labels are elements and need to be converted to plain text to enable navigation using character keys on a keyboard.

A function to convert the currently selected value to a string. Used to set a value of a hidden input associated with the select, so that the selected value can be posted with a form.

id attribute of the listbox element.

Controls the open state of the select's listbox.

If true, selecting multiple values is allowed. This affects the type of the value, defaultValue, and onChange props.

Name of the element. For example used by the server to identify the fields in form submits. If the name is provided, the component will render a hidden input element that can be submitted to a server.

Callback fired when an option is selected.

Callback fired when the component requests to be opened. Use in controlled mode (see listboxOpen).

Text to show when there is no selected value.

Function that customizes the rendering of the selected value.

If true, the Select cannot be empty when submitting form.

The props used for each slot inside the Input.

The components used for each slot inside the Select. Either a string to use a HTML element or a component.

The selected value. Set to null to deselect all options.