Props
Attributes
- Graph
-
- Supertypes
-
trait PropTypesclass Objecttrait Matchableclass Any
Members list
Type members
Classlikes
Control if the input should be blurred when an option is selected:
Control if the input should be blurred when an option is selected:
false
the input is not blurred.true
the input is always blurred.touch
the input is blurred after a touch event.mouse
the input is blurred after a mouse event.
Attributes
- Supertypes
-
class Prop[String | Boolean]class Objecttrait Matchableclass Any
- Self type
-
blurOnSelect.type
Force the visibility display of the popup icon.
Force the visibility display of the popup icon.
Attributes
- Supertypes
-
class Prop[String | Boolean]class Objecttrait Matchableclass Any
- Self type
-
forcePopupIcon.type
Value members
Concrete methods
Props applied to the Chip
element.
The component used to render the listbox.
The component used to render the listbox.
Attributes
Props applied to the Listbox element.
Props applied to the Listbox element.
Attributes
The component used to render the body of the popup.
The component used to render the body of the popup.
Attributes
The component used to position the popup.
The component used to position the popup.
Attributes
If true
, the portion of the selected suggestion that has not been typed by the user, known as the completion string, appears inline after the input cursor in the textbox. The inline completion string is visually highlighted and has a selected state.
If true
, the portion of the selected suggestion that has not been typed by the user, known as the completion string, appears inline after the input cursor in the textbox. The inline completion string is visually highlighted and has a selected state.
Attributes
If true
, the first option is automatically highlighted.
If true
, the first option is automatically highlighted.
Attributes
If true
, the selected option becomes the value of the input when the Autocomplete loses focus unless the user chooses a different option or changes the character string in the input.
If true
, the selected option becomes the value of the input when the Autocomplete loses focus unless the user chooses a different option or changes the character string in the input.
When using freeSolo
mode, the typed value will be the input value if the Autocomplete loses focus without highlighting an option.
Attributes
Override or extend the styles applied to the component.
Override or extend the styles applied to the component.
Attributes
The icon to display in place of the default clear icon.
The icon to display in place of the default clear icon.
Attributes
If true
, the input's text is cleared on blur if no value is selected.
If true
, the input's text is cleared on blur if no value is selected.
Set to true
if you want to help the user enter a new value. Set to false
if you want to help the user resume their search.
Attributes
If true
, clear all values when the user presses escape and the popup is closed.
If true
, clear all values when the user presses escape and the popup is closed.
Attributes
Override the default text for the clear icon button.
Override the default text for the clear icon button.
For localization purposes, you can use the provided translations.
Attributes
Override the default text for the close popup icon button.
Override the default text for the close popup icon button.
For localization purposes, you can use the provided translations.
Attributes
The props used for each slot inside.
The props used for each slot inside.
Attributes
The default value. Use when the component is not controlled.
The default value. Use when the component is not controlled.
Attributes
If true
, the input can't be cleared.
If true
, the input can't be cleared.
Attributes
If true
, the popup won't close when a value is selected.
If true
, the popup won't close when a value is selected.
Attributes
If true
, the list box in the popup will not wrap focus.
If true
, the list box in the popup will not wrap focus.
Attributes
If true
, the Popper
content will be under the DOM hierarchy of the parent component.
If true
, the Popper
content will be under the DOM hierarchy of the parent component.
Attributes
If true
, the component is disabled.
If true
, the component is disabled.
Attributes
If true
, will allow focus on disabled items.
If true
, will allow focus on disabled items.
Attributes
A function that determines the filtered options to be rendered on search.
A function that determines the filtered options to be rendered on search.
Value parameters
- {Value[]}
-
options The options to render.
- {object}
-
state The state of the component.
Attributes
If true
, hide the selected options from the list box.
If true
, hide the selected options from the list box.
Attributes
If true
, the Autocomplete is free solo, meaning that the user input is not bound to provided options.
If true
, the Autocomplete is free solo, meaning that the user input is not bound to provided options.
Attributes
If true
, the input will take up the full width of its container.
If true
, the input will take up the full width of its container.
Attributes
The label to display when the tags are truncated (limitTags
).
The label to display when the tags are truncated (limitTags
).
Value parameters
- {number}
-
more The number of truncated tags.
Attributes
Used to determine the disabled state for a given option.
Used to determine the disabled state for a given option.
Value parameters
- {Value}
-
option The option to test.
Attributes
Used to determine the key for a given option. This can be useful when the labels of options are not unique (since labels are used as keys by default).
Used to determine the key for a given option. This can be useful when the labels of options are not unique (since labels are used as keys by default).
Value parameters
- {Value}
-
option The option to get the key for.
Attributes
Used to determine the string value for a given option. It's used to fill the input (and the list box options if renderOption
is not provided).
Used to determine the string value for a given option. It's used to fill the input (and the list box options if renderOption
is not provided).
If used in free solo mode, it must accept both the type of the options and a string.
Value parameters
- {Value}
-
option
Attributes
If provided, the options will be grouped under the returned string. The groupBy value is also used as the text for group headings when renderGroup
is not provided.
If provided, the options will be grouped under the returned string. The groupBy value is also used as the text for group headings when renderGroup
is not provided.
Value parameters
- {Value}
-
options The options to group.
Attributes
If true
, the component handles the "Home" and "End" keys when the popup is open. It should move focus to the first option and last option, respectively.
If true
, the component handles the "Home" and "End" keys when the popup is open. It should move focus to the first option and last option, respectively.
Attributes
This prop is used to help implement the accessibility logic. If you don't provide an id it will fall back to a randomly generated one.
This prop is used to help implement the accessibility logic. If you don't provide an id it will fall back to a randomly generated one.
Attributes
If true
, the highlight can move to the input.
If true
, the highlight can move to the input.
Attributes
The input value.
The input value.
Attributes
Used to determine if the option represents the given value. Uses strict equality by default. ⚠️ Both arguments need to be handled, an option can only match with one value.
Used to determine if the option represents the given value. Uses strict equality by default. ⚠️ Both arguments need to be handled, an option can only match with one value.
Value parameters
- {Value}
-
value The value to test against.
Attributes
The maximum number of tags that will be visible when not focused. Set -1
to disable the limit.
The maximum number of tags that will be visible when not focused. Set -1
to disable the limit.
Attributes
If true
, the component is in a loading state. This shows the loadingText
in place of suggestions (only if there are no suggestions to show, e.g. options
are empty).
If true
, the component is in a loading state. This shows the loadingText
in place of suggestions (only if there are no suggestions to show, e.g. options
are empty).
Attributes
Text to display when in a loading state.
Text to display when in a loading state.
For localization purposes, you can use the provided translations.
Attributes
If true
, value
must be an array and the menu will support multiple selections.
If true
, value
must be an array and the menu will support multiple selections.
Attributes
Text to display when there are no options.
Text to display when there are no options.
For localization purposes, you can use the provided translations.
Attributes
Callback fired when the value changes.
Callback fired when the value changes.
Value parameters
- {React.SyntheticEvent}
-
event The event source of the callback.
- {Value|Value[]}
-
value The new value of the component.
- {string}
-
[details]
Attributes
Callback fired when the popup requests to be closed. Use in controlled mode (see open).
Callback fired when the popup requests to be closed. Use in controlled mode (see open).
Value parameters
- {React.SyntheticEvent}
-
event The event source of the callback.
- {string}
-
reason Can be:
"toggleInput"
,"escape"
,"selectOption"
,"removeOption"
,"blur"
.
Attributes
Callback fired when the highlight option changes.
Callback fired when the highlight option changes.
Value parameters
- {React.SyntheticEvent}
-
event The event source of the callback.
- {Value}
-
option The highlighted option.
- {string}
-
reason Can be:
"keyboard"
,"auto"
,"mouse"
,"touch"
.
Attributes
Callback fired when the input value changes.
Callback fired when the input value changes.
Value parameters
- {React.SyntheticEvent}
-
event The event source of the callback.
- {string}
-
reason Can be:
"input"
(user input),"reset"
(programmatic change),"clear"
.
Attributes
Callback fired when the popup requests to be opened. Use in controlled mode (see open).
Callback fired when the popup requests to be opened. Use in controlled mode (see open).
Value parameters
- {React.SyntheticEvent}
-
event The event source of the callback.
Attributes
If true
, the component is shown.
If true
, the component is shown.
Attributes
If true
, the popup will open on input focus.
If true
, the popup will open on input focus.
Attributes
Override the default text for the open popup icon button.
Override the default text for the open popup icon button.
For localization purposes, you can use the provided translations.
Attributes
Array of options.
Array of options.
Attributes
The icon to display in place of the default popup icon.
The icon to display in place of the default popup icon.
Attributes
If true
, the component becomes readonly. It is also supported for multiple tags where the tag cannot be deleted.
If true
, the component becomes readonly. It is also supported for multiple tags where the tag cannot be deleted.
Attributes
Render the group.
Render the group.
Value parameters
- {AutocompleteRenderGroupParams}
-
params The group to render.
Attributes
Render the input.
Render the input.
Value parameters
- {object}
-
params
Attributes
Render the option, use getOptionLabel
by default.
Render the option, use getOptionLabel
by default.
Value parameters
- {Value}
-
option The option to render.
- {object}
-
ownerState The state of the Autocomplete component.
Attributes
Render the selected value.
Render the selected value.
Value parameters
- {Value[]}
-
value The
value
provided to the component. - {function}
-
getTagProps A tag props getter.
- {object}
-
ownerState The state of the Autocomplete component.
Attributes
If true
, the input's text is selected on focus. It helps the user clear the selected value.
If true
, the input's text is selected on focus. It helps the user clear the selected value.
Attributes
The props used for each slot inside.
The props used for each slot inside.
Attributes
The system prop that allows defining system overrides as well as additional CSS styles.
The system prop that allows defining system overrides as well as additional CSS styles.
Attributes
The value of the autocomplete.
The value of the autocomplete.
The value must have reference equality with the option in order to be selected. You can customize the equality behavior with the isOptionEqualToValue
prop.
Attributes
Inherited methods
Attributes
- Inherited from:
- PropTypes
Inherited fields
Attributes
- Inherited from:
- PropTypes