Optional
aboutOptional
accessOptional
aria-Optional
aria-Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute.
Optional
aria-Indicates whether inputting text could trigger display of one or more predictions of the user's intended value for an input and specifies how predictions would be presented if they are made.
Optional
aria-Defines a string value that labels the current element, which is intended to be converted into Braille.
Optional
aria-Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille.
Optional
aria-Optional
aria-Indicates the current "checked" state of checkboxes, radio buttons, and other widgets.
Optional
aria-Defines the total number of columns in a table, grid, or treegrid.
Optional
aria-Defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid.
Optional
aria-Defines a human readable text alternative of aria-colindex.
Optional
aria-Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid.
Optional
aria-Identifies the element (or elements) whose contents or presence are controlled by the current element.
Optional
aria-Indicates the element that represents the current item within a container or set of related elements.
Optional
aria-Identifies the element (or elements) that describes the object.
Optional
aria-Defines a string value that describes or annotates the current element.
Optional
aria-Identifies the element that provides a detailed, extended description for the object.
Optional
aria-Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable.
Optional
aria-Indicates what functions can be performed when a dragged object is released on the drop target.
Optional
aria-Identifies the element that provides an error message for the object.
Optional
aria-Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed.
Optional
aria-Identifies the next element (or elements) in an alternate reading order of content which, at the user's discretion, allows assistive technology to override the general default of reading in document source order.
Optional
aria-Indicates an element's "grabbed" state in a drag-and-drop operation.
Optional
aria-Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element.
Optional
aria-Indicates whether the element is exposed to an accessibility API.
Optional
aria-Indicates the entered value does not conform to the format expected by the application.
Optional
aria-Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element.
Optional
aria-Defines a string value that labels the current element.
Optional
aria-Identifies the element (or elements) that labels the current element.
Optional
aria-Defines the hierarchical level of an element within a structure.
Optional
aria-Indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region.
Optional
aria-Indicates whether an element is modal when displayed.
Optional
aria-Indicates whether a text box accepts multiple lines of input or only a single line.
Optional
aria-Indicates that the user may select more than one item from the current selectable descendants.
Optional
aria-Indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous.
Optional
aria-Identifies an element (or elements) in order to define a visual, functional, or contextual parent/child relationship between DOM elements where the DOM hierarchy cannot be used to represent the relationship.
Optional
aria-Defines a short hint (a word or short phrase) intended to aid the user with data entry when the control has no value. A hint could be a sample value or a brief description of the expected format.
Optional
aria-Defines an element's number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
Optional
aria-Indicates the current "pressed" state of toggle buttons.
Optional
aria-Indicates that the element is not editable, but is otherwise operable.
Optional
aria-Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified.
Optional
aria-Indicates that user input is required on the element before a form may be submitted.
Optional
aria-Defines a human-readable, author-localized description for the role of an element.
Optional
aria-Defines the total number of rows in a table, grid, or treegrid.
Optional
aria-Defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid.
Optional
aria-Defines a human readable text alternative of aria-rowindex.
Optional
aria-Defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid.
Optional
aria-Indicates the current "selected" state of various widgets.
Optional
aria-Defines the number of items in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM.
Optional
aria-Indicates if items in a table or grid are sorted in ascending or descending order.
Optional
aria-Defines the maximum allowed value for a range widget.
Optional
aria-Defines the minimum allowed value for a range widget.
Optional
aria-Defines the current value for a range widget.
Optional
aria-Defines the human readable text alternative of aria-valuenow for a range widget.
Optional
autoOptional
autoIf true
, the portion of the selected suggestion that the user hasn't typed,
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.
Optional
autoOptional
autoOptional
autoIf true
, the first option is automatically highlighted.
Optional
autoOptional
autoIf 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 the freeSolo
mode, the typed value will be the input value
if the Autocomplete loses focus without highlighting an option.
Optional
blurControl 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.Optional
ChipProps applied to the Chip
element.
Optional
classesOverride or extend the styles applied to the component.
Optional
classOptional
clearThe icon to display in place of the default clear icon.
Optional
clearIf true
, the input's text is cleared on blur if no value is selected.
Set it to true
if you want to help the user enter a new value.
Set it to false
if you want to help the user resume their search.
Optional
clearIf true
, clear all values when the user presses escape and the popup is closed.
Optional
clearOverride the default text for the clear icon button.
For localization purposes, you can use the provided translations.
Optional
closeOverride the default text for the close popup icon button.
For localization purposes, you can use the provided translations.
Optional
colorThe color of the component. It supports both default and custom theme colors, which can be added as shown in the palette customization guide.
Optional
componentThe component name that is using this hook. Used for warnings.
Optional
componentsThe props used for each slot inside.
Optional
contentOptional
contentOptional
contextOptional
dangerouslyOptional
datatypeOptional
defaultOptional
defaultThe default value. Use when the component is not controlled.
Optional
dirOptional
disableIf true
, the input can't be cleared.
Optional
disableIf true
, the popup won't close when a value is selected.
Optional
disabledIf true
, the component is disabled.
Optional
disabledIf true
, will allow focus on disabled items.
Optional
disableIf true
, the list box in the popup will not wrap focus.
Optional
disableIf true
, the Popper
content will be under the DOM hierarchy of the parent component.
Optional
draggableOptional
enterOptional
errorIf true
, the label is displayed in an error state.
Optional
exportpartsOptional
filterIf true
, hide the selected options from the list box.
Optional
focusOptional
forceForce the visibility display of the popup icon.
Optional
freeIf true
, the Autocomplete is free solo, meaning that the user input is not bound to provided options.
Optional
fullIf true
, the input will take up the full width of its container.
Optional
getThe label to display when the tags are truncated (limitTags
).
The number of truncated tags.
Optional
getUsed to determine the disabled state for a given option.
The option to test.
Optional
getUsed 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).
The option to get the key for.
Optional
groupIf 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.
Optional
handleIf 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.
Optional
helperThe helper text content.
Optional
hiddenOptional
includeIf true
, the highlight can move to the input.
Optional
inertOptional
inlistOptional
inputHints at the type of data that might be entered by the user while editing the element or its contents
Optional
inputThe input value.
Optional
isSpecify that a standard HTML element should behave like a defined custom built-in element
Optional
itemIDOptional
itemOptional
itemOptional
itemOptional
itemOptional
langOptional
limitThe maximum number of tags that will be visible when not focused.
Set -1
to disable the limit.
Optional
ListboxThe component used to render the listbox.
Optional
ListboxProps applied to the Listbox element.
Optional
loadingIf true
, the component is in a loading state.
This shows the loadingText
in place of suggestions (only if there are no suggestions to show, for example options
are empty).
Optional
loadingText to display when in a loading state.
For localization purposes, you can use the provided translations.
Optional
nonceOptional
noText to display when there are no options.
For localization purposes, you can use the provided translations.
Optional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onCallback fired when the popup requests to be closed. Use in controlled mode (see open).
The event source of the callback.
Can be: "toggleInput"
, "escape"
, "selectOption"
, "removeOption"
, "blur"
.
Optional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onCallback fired when the highlight option changes.
The event source of the callback.
The highlighted option.
Can be: "keyboard"
, "auto"
, "mouse"
, "touch"
.
Optional
onOptional
onOptional
onCallback fired when the input value changes.
The event source of the callback.
The new value of the text input.
Can be: "input"
(user input), "reset"
(programmatic change), "clear"
.
Optional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onCallback fired when the popup requests to be opened. Use in controlled mode (see open).
The event source of the callback.
Optional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
onOptional
openIf true
, the component is shown.
Optional
openIf true
, the popup will open on input focus.
Optional
openOverride the default text for the open popup icon button.
For localization purposes, you can use the provided translations.
Optional
PaperThe component used to render the body of the popup.
Optional
partOptional
popoverOptional
popoverOptional
popoverOptional
PopperThe component used to position the popup.
Optional
popupThe icon to display in place of the default popup icon.
Optional
prefixOptional
propertyOptional
radioOptional
readIf true
, the component becomes readonly. It is also supported for multiple tags where the tag cannot be deleted.
Optional
refOptional
relOptional
renderRender the group.
The group to render.
Optional
renderRender the option, use getOptionLabel
by default.
The props to apply on the li element.
The option to render.
The state of each option.
The state of the Autocomplete component.
Optional
renderRender the selected value.
The value
provided to the component.
A tag props getter.
The state of the Autocomplete component.
Optional
resourceOptional
resultsOptional
revOptional
roleOptional
securityOptional
selectIf true
, the input's text is selected on focus.
It helps the user clear the selected value.
Optional
sizeThe size of the component.
Optional
slotOptional
slotThe props used for each slot inside.
Optional
spellOptional
styleOptional
suppressOptional
suppressOptional
sxThe system prop that allows defining system overrides as well as additional CSS styles.
Optional
tabOptional
titleOptional
translateOptional
twSpecify styles using Tailwind CSS classes. This feature is currently experimental.
If style
prop is also specified, styles generated with tw
prop will be overridden.
Example:
tw='w-full h-full bg-blue-200'
tw='text-9xl'
tw='text-[80px]'
Optional
typeOptional
typeofOptional
unselectableOptional
Internal
unstable_The prefix of the state class name, temporary for Joy UI
Optional
Internal
unstable_Temporary for Joy UI because the parent listbox is the document object TODO v6: Normalize the logic and remove this param.
Optional
variantThe variant to use.
Optional
vocab
Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application.