UseSelectParameters

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

The ref of the trigger button element.

The name of the component using useSelect. For debugging purposes.

If true, the select will be open by default.

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. This is useful when labels are elements and need to be converted to plain text to enable keyboard navigation with character keys.

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.

The id attribute of the listbox element.

The ref of the listbox element.

If true, the end user can select multiple values. This affects the type of the value, defaultValue, and onChange props.

The name attribute of the hidden input element. This is useful when the select is embedded in a form and you want to access the selected value in the form data.

Callback fired when an option is selected.

Callback fired when an option is highlighted.

Callback fired when the listbox is opened or closed.

Controls the open state of the select's listbox. This is the controlled equivalent of the defaultOpen prop.

An alternative way to specify the options. If this parameter is set, options defined as JSX children are ignored.

If true, the select embedded in a form must have a selected value. Otherwise, the form submission will fail.

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