@headlessui/react
2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed
Upgrading @headlessui/react From 1.7.19 to 2.0.0
1 release in betweenevery note read
Reading releases, release notes and advisories…
- 4
- changes to make
- 0
- advisories fixed
- 13
- new
- 8
- fixes
Before you upgrade
Tick each one off as you go- Breaking2.0.0
- Deprecated2.0.0
- Deprecated2.0.0
- Deprecated2.0.0
Release by release
- Breaking
- Deprecated
Deprecate the
RadioGroup.Optioncomponent in favor of newRadiocomponent - Deprecated
Deprecate the
activeprop in favor of newfocusprop - Deprecated
Deprecate the
enteredprop on theTransitioncomponent
10 other lines we could not sort, mostly version bumps
- 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
- 2.0.0
Attempt form submission when pressing enter on the
ListboxButtoncomponent
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.