v7.0.0
Breaking changes:
- Renamed
autoresize
prop toallowResize
- Renamed
delimiters
prop todelimiterKeys
- Renamed
noSuggestionsText
tonoOptionsText
- Renamed
onAddition
prop toonAdd
- Renamed
removeButtonText
todeleteButtonText
- Renamed
suggestionComponent
torenderOption
- Renamed
tags
prop toselected
- Renamed
tagComponent
torenderTag
- Removed
addOnBlur
prop, can be implemented manually - Removed
inputAttributes
prop, userenderInput
prop instead - Removed
maxSuggestionsLength
prop, usesuggestionsTransform
prop instead - Removed
minQueryLength
prop, useonShouldExpand
prop instead - Removed
suggestionsFilter
prop, usesuggestionsTransform
prop instead
New features and improvements:
- Added
onExpand
andonCollapse
callbacks - Added a label sub component to improve accessibility
- Added assistive text notifications for changes to selected tags
- Added support for more combobox keyboard behavior to match the ARIA spec
- Added support for displaying the selected state of options in the listbox
- Added support for scrolling the listbox and maintaining the the active option in view
- Added support for interpolating values with text props
- Added support for displaying disabled state using
isDisabled
prop - Added support for displaying invalid state using
isInvalid
prop - Added support for related descriptive text using
ariaDescribedBy
prop - Added support for related error status text using
ariaErrorMessage
prop - Added support for controlling the listbox when selecting a tag using
collapseOnSelect
prop - Added support for controlling the listbox using
onShouldExpand
andonShouldCollapse
props - Added support for activating the first option when the listbox expands using
activateFirstOption
prop - Added support for rendering a custom root component using
renderRoot
prop - Added support for rendering a custom label component using
renderLabel
prop - Added support for rendering a custom input component using
renderInput
prop - Added support for rendering a custom text highlight component using
renderHighlight
prop
Other changes:
- When the
allowNew
prop is enabled a new tag can only be created when selecting the new tag option from the listbox. - Tags can no longer be selected multiple times. Choosing a previously selected tag will now trigger a deletion.
Please refer to the migration guide if upgrading from v6 to v7.