@headlessui/react
2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed
Upgrading @headlessui/react From 1.7.2 to 2.2.10
44 releases in betweenevery note read
Reading releases, release notes and advisories…
- 5
- changes to make
- 0
- advisories fixed
- 32
- new
- 191
- fixes
Before you upgrade
Tick each one off as you go- Breaking2.0.0
- Deprecated2.0.4
- Deprecated2.0.0
- Deprecated2.0.0
- Deprecated2.0.0
Release by release
- Fixed
Don’t render
<Portal>while hydrating - Fixed
Fix passing props on
Fragmenterror due toSymbol(react.lazy)
- Fixed
- Fixed
Improve focus management in shadow DOM roots
- Fixed
Don't accidentally open the
Comboboxwhen touching theComboboxButtonwhile dragging on mobile - Fixed
Ensure sibling
Dialogcomponents are scrollable on mobile - Fixed
Infer
Comboboxtype based ononChangehandler
- Fixed
- Fixed
Ensure we are not freezing data when the
staticprop is used - Fixed
Ensure
onChangetypes are contravariant instead of bivariant - Fixed
Support
<summary>as a focusable element inside<details> - Fixed
Fix
Maximum update depth exceededcrash when usingtransitionprop
- Fixed
- Fixed
Fix incorrect double invocation of menu items, listbox options and combobox options
- Fixed
Fix memory leak in SSR environment
- Fixed
Ensure programmatic
.click()onMenuButtonref works - Fixed
Don't activate hovered items while using the keyboard
- Fixed
- Fixed
Fix immediately closing Listbox by requiring some cursor movement
- Fixed
- Fixed
Fix listbox closing immediately after opening on touch devices
- Fixed
- Fixed
Fix
Comboboxerror (unexpected undefined) when using virtual mode
- Fixed
- New
Add a quick trigger action to the
Menu,ListboxandComboboxcomponents - Fixed
Fix clicking
Labelcomponent should open<Input type="file"> - Fixed
Ensure clicking on interactive elements inside
Labelcomponent works - Fixed
Fix focus not returned to SVG Element
- Fixed
Fix
Listboxnot focusing first or last option on ArrowUp / ArrowDown - Fixed
Performance improvement: only re-render top-level component when nesting components e.g.:
Menuinside aDialog - Fixed
Fix closing
Menuwhen otherMenuis opened
- New
13 other lines we could not sort, mostly version bumps
- 2.0.4
Use native
fieldsetinstead ofdivby default forFieldsetcomponent - 2.0.0
Built-in anchor positioning — using Floating UI, components like
Menu,Listbox, and more can now automatically position their popovers to be anchored to their trigger, adapting as needed to changes in the viewport. - 2.0.0
Headless checkbox component — we've added a headless
Checkboxcomponent to complement our existingRadioGroupcomponent, making it easy to build totally custom checkbox controls. - 2.0.0
HTML form components — we've added
Input,Select,Textarea,Label,Description,Fieldset, andLegendcomponents that handle all of the ID generation andaria-*attribute mapping you need to do to connect form fields together. - 2.0.0
Improved hover and focus-visible detection — using hooks from the awesome React Aria library under the hood, Headless UI now adds smarter
data-hoveranddata-focusattributes to your controls that behave more consistently across different devices than the native pseudo-classes. - 2.0.0
Combobox list virtualization — the
Comboboxcomponent can now handle giant lists of options with no performance issues. - 2.0.0
Always render hidden form input fields for
Checkbox,SwitchandRadioGroupcomponents - 2.0.0
Dialog is now focused by default instead of the first focusable element
- 2.0.0
Change default tags for
ListboxOptions,ListboxOption,ComboboxOptions,ComboboxOption, andTabGroupcomponents - 2.0.0
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.