@headlessui/react
2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed
Upgrading @headlessui/react From 1.6.0 to 1.7.19
26 releases in betweenevery note read
Reading releases, release notes and advisories…
- 1
- change to make
- 0
- advisories fixed
- 14
- new
- 151
- fixes
Before you upgrade
Tick each one off as you go- Breaking1.7.1
Release by release
- New
Add
hiddenattribute to internalHiddencomponent when theFeatures.Hiddenfeature is used - Fixed
Make sure panels re-register when IDs are calculated in React < 18
- Fixed
Expose
disabledstate onTabcomponent - Fixed
Prevent default behaviour when clicking outside of a
Dialog.Panel - Fixed
Allow setting custom
tabIndexon theSwitchcomponent - Fixed
Forward
disabledstate to hidden inputs in form-like components - Fixed
Respect
selectedIndexfor controlledTabcomponents
- New
- New
Add support for
role="alertdialog"to<Dialog>component - Fixed
Don't call
<Dialog>'sonClosetwice on mobile devices - Fixed
Lazily resolve default containers in
<Dialog> - Fixed
Ensure hidden
Tab.Panelcomponents are hidden from the accessibility tree
- New
- Fixed
Use correct value when resetting
<Listbox multiple>and<Combobox multiple> - Fixed
Render
<MainTreeNode />inPopover.Groupcomponent only - Fixed
Disable smooth scrolling when opening/closing
Dialogcomponents on iOS - Fixed
Don't assume
<Tab />components are available when setting the next index
- Fixed
- Fixed
Ensure the caret is in a consistent position when syncing the
Combobox.Inputvalue - Fixed
Improve "outside click" behaviour in combination with 3rd party libraries
- Fixed
Ensure IME works on Android devices
- Fixed
Calculate
aria-expandedpurely based on the open/closed state - Fixed
Submit form on
Entereven if no submit-like button was found
- Fixed
- New
Add demo mode to
MenuandPopovercomponents - Fixed
Ensure
FocusTrapis only active when the givenenabledvalue istrue - Fixed
Stop
<Transition appear>from overwriting classes on re-render - Fixed
Improve control over
MenuandListboxoptions while searching - Fixed
Consider clicks inside iframes to be "outside"
- Fixed
Ensure moving focus within a
Portalcomponent, does not close thePopovercomponent
- New
- New
Add
FocusTrapevent listeners once document has loaded - New
Add
formprop to form-like components such asRadioGroup,Switch,Listbox, andCombobox - Fixed
Fix focus styles showing up when using the mouse
- Fixed
Fix "Can't perform a React state update on an unmounted component." when using the
Transitioncomponent - Fixed
Fix
classNamehydration for<Transition appear> - Fixed
Improve
Comboboxtypes to improve false positives - Fixed
Merge
classNamecorrectly when it’s a function
- New
- Fixed
Ensure
Transitioncomponent completes if nothing is transitioning - Fixed
Enable native label behavior for
<Switch>where possible - Fixed
Allow root containers from the
Dialogcomponent in theFocusTrapcomponent - Fixed
Fix
XYZPropsWeControland cleanup internal TypeScript types - Fixed
Fix invalid warning when using multiple
Popover.Buttoncomponents inside aPopover.Panel - Fixed
Fix restore focus to buttons in Safari, when
Dialogcomponent closes
- Fixed
- New
Add explicit props types for every component
- Fixed
Ensure the main tree and parent
Dialogcomponents are marked asinert - Fixed
Fix nested
Popovercomponents not opening - Fixed
Make React types more compatible with other libraries
- Fixed
Fix
Dialogcleanup when theDialogbecomes hidden
- New
2 other lines we could not sort, mostly version bumps
- 1.7.15
Move
typescondition to the front - 1.7.10
Revert "Use the
import * as React from 'react'pattern
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.