- Added support for configuring position of new tag option using
newOptionPosition
prop - Refactored typings to use
React.JSX
instead of globalJSX
, contributed by @memark
- Added support for rendering a custom selected tags list component using
renderTagList
prop
- Fixed an issue where deleting multiple selected tags would fail to maintain cursor focus
- Refactored focus trap to return focus to the component root instead of the input
- Added support for rendering a custom list box component using
renderListBox
prop - Fixed an issue where auto scrolling to the active option in the list box could also scroll parent containers
- Fixed an issue where the
onShouldExpand
andonShouldCollapse
callbacks would receive the previous value on input
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.
Please refer to the changelog in the old project repository.