Autocomplete
If you don't need to display a large list of options, use Select.
Autocomplete
is an input that suggests options list based on the term typed. This options must be updated with each keystroke. Use it when you need to find an option within a very large volume of information.
Item typesβ
It is currently not possible to customize the style of the Autocomplete
options.
Auxiliary textβ
It allows you to use a main text to describe the option and, if necessary, a supporting text to supplement it.
With iconβ
Icons add complexity and can impact reading options, so use only when really necessary.
Icons are optional decorative elements that reinforce the meaning of an option and always appear to the left of the main text.
With Tag
componentβ
Use the Tag
component when you need to highlight an option.
Dividersβ
Line dividerβ
Use the line-style divider when you need to create a visual separation between options.
Grouper with textβ
When the intention is to create a grouping of options, use the text divider, in which you can add a name for the group of options.
Clear fieldβ
Defaultβ
To clear the field, just click on the "x" located to the right of the Autocomplete
field. The "x" appears after any value is typed.
Multiple selectionβ
To remove all selections at once, just click on the "x" located to the right of the Autocomplete
field. It is also possible to individually remove each selected option by clicking on the "x" of each option.
When the number of selected options is greater than the field size, the tags are rearranged. Multi-selection Autocomplete
is the only input component that allows you to change the height.
Without resultsβ
When no options are found, by default no message should be displayed. A message can be added and customized if needed.
You can add a new option to the list by changing the state of options being rendered. For more details visit our examples tab.
Loadingβ
When Autocomplete
has asynchronous loading, it is possible to add the loading
property so that the Spinner
appears inside the field.