@headlessui/react
2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed
72 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 2.x · latest line
2.2.10
7 Apr 2026Don’t render
<Portal>while hydratingFix passing props on
Fragmenterror due toSymbol(react.lazy)
2.2.9
25 Sep 2025Improve focus management in shadow DOM roots
Don't accidentally open the
Comboboxwhen touching theComboboxButtonwhile dragging on mobileEnsure sibling
Dialogcomponents are scrollable on mobile
Fixed
Improve focus management in shadow DOM roots
Don't accidentally open the
Comboboxwhen touching theComboboxButtonwhile dragging on mobileEnsure sibling
Dialogcomponents are scrollable on mobileInfer
Comboboxtype based ononChangehandlerAllow home/end key default behavior inside
ComboboxInputwhenComboboxis closedEnsure interacting with a
Dialogon iOS works after interacting with a disallowed areaFreeze Listbox values as soon as a value is selected
Ensure refs are forwarded when freezing data
Do not serialize React components into form fields
2.2.8
12 Sep 2025Ensure we are not freezing data when the
staticprop is usedEnsure
onChangetypes are contravariant instead of bivariantSupport
<summary>as a focusable element inside<details>
Fixed
Ensure we are not freezing data when the
staticprop is usedEnsure
onChangetypes are contravariant instead of bivariantSupport
<summary>as a focusable element inside<details>Fix
Maximum update depth exceededcrash when usingtransitionpropEnsure pressing
Tabin theComboboxInput, correctly syncs the input valueEnsure
--button-widthand--input-widthhave the latest valueFix 'Invalid prop
data-headlessui-statesupplied toReact.Fragment' warningEnsure
elementinrefcallback is always connected when rendering in aPortalEnsure form state is up to date when using uncontrolled components
Ensure
data-openonComboboxInputis up to dateEnsure changing the
immediateprop value on theComboboxcomponent works as expected
2.2.7
30 Jul 2025Fix incorrect double invocation of menu items, listbox options and combobox options
Fix memory leak in SSR environment
Ensure programmatic
.click()onMenuButtonref works
Fixed
Fix incorrect double invocation of menu items, listbox options and combobox options
Fix memory leak in SSR environment
Ensure programmatic
.click()onMenuButtonref worksDon't activate hovered items while using the keyboard
2.2.6
24 Jul 2025Fix immediately closing Listbox by requiring some cursor movement
2.2.5
23 Jul 2025Fix listbox closing immediately after opening on touch devices
2.2.4
20 May 2025Fix
Comboboxerror (unexpected undefined) when using virtual mode
2.2.3
12 May 2025Add a quick trigger action to the
Menu,ListboxandComboboxcomponentsFix clicking
Labelcomponent should open<Input type="file">Ensure clicking on interactive elements inside
Labelcomponent works
Added
Add a quick trigger action to the
Menu,ListboxandComboboxcomponents
Fixed
Fix clicking
Labelcomponent should open<Input type="file">Ensure clicking on interactive elements inside
Labelcomponent worksFix focus not returned to SVG Element
Fix
Listboxnot focusing first or last option on ArrowUp / ArrowDownPerformance improvement: only re-render top-level component when nesting components e.g.:
Menuinside aDialogFix closing
Menuwhen otherMenuis opened
2.2.2
17 Apr 2025Improve
Menucomponent performanceImprove
Listboxcomponent performanceImprove
Comboboxcomponent performance
Fixed
Improve
Menucomponent performanceImprove
Listboxcomponent performanceImprove
Comboboxcomponent performanceOpen
MenuandListboxonmousedownFix
Transitioncomponent from incorrectly exposing theClosingstate
2.2.1
4 Apr 2025Accept
tabIndexon theCheckboxcomponentAccept
tabIndexon theRadioGroupcomponentUse correct
ownerDocumentwhen using internalPortalcomponent
Added
Accept
tabIndexon theCheckboxcomponentAccept
tabIndexon theRadioGroupcomponent
Fixed
Use correct
ownerDocumentwhen using internalPortalcomponentBump
@tanstack/react-virtualto fix warnings in React 19 projectsFix
aria-invalidattributes to have a valid'true'valueAdd missing
invalidprop toComboboxcomponentFix
Unexpected undefinedcrash inComboboxcomponent withvirtualmode
2.2.0
25 Oct 2024Add React 19 support
2.1.10
10 Oct 2024Use
React.JSXinstead of deprecated globalJSXFix crash in
ListboxOptionswhen usingas={Fragment}
2.1.9
3 Oct 2024Ensure
Elementis available before polyfilling to prevent crashes in non-browser environmentsFix crash when using
instanceof HTMLElementin some environmentsCleanup
processin Combobox component when using virtualization
2.1.8
12 Sep 2024Fix crash when using
as={Fragment}onMenuButton,ListboxButton,DisclosureButtonorButtoncomponents
2.1.7
11 Sep 2024Prevent crash in environments where
Element.prototype.getAnimationsis not available
2.1.6
9 Sep 2024Fix
ListboxOptionsbeing incorrectly marked asinertFix crash when using
DisclosureButtoninside of aDisclosurePanelwhen theDisclosureis open by default
2.1.5
4 Sep 2024Fix transition bug on Firefox, triggered by clicking the
PopoverButtonin rapid succession
2.1.4
3 Sep 2024Fix components not closing properly when using the
transitionprop
2.1.3
23 Aug 2024Ensure
Transitioncomponent state doesn't change when it becomes hiddenFix closing components using the
transitionprop, and after scrolling the pageEnsure all client components are marked correctly to avoid a crash with React 19 and Turbopack
2.1.2
5 Jul 2024Fix prematurely added anchoring styles on
ListboxOptionsEnsure
unmountonDialogworks in combination with thetransitionprop onDialogBackdropandDialogPanelcomponentsFix crash in
Comboboxcomponent when invirtualmode when options are empty
Fixed
Fix prematurely added anchoring styles on
ListboxOptionsEnsure
unmountonDialogworks in combination with thetransitionprop onDialogBackdropandDialogPanelcomponentsFix crash in
Comboboxcomponent when invirtualmode when options are emptyFix hanging tests when using
anchorpropFix
transitionandfocusprop combination forPopoverPanelcomponentFix outside click in nested portalled
PopovercomponentsFix restoring focus to correct element when closing
DialogcomponentFix
flushSyncwarning forComboboxcomponent withimmediateprop enabled
2.1.1
26 Jun 2024Fix issues spreading omitted props onto components
Fix initial
anchor="selection"positioningFix render prop in
ComboboxOptionsto useanyinstead ofunknown
Fixed
Fix issues spreading omitted props onto components
Fix initial
anchor="selection"positioningFix render prop in
ComboboxOptionsto useanyinstead ofunknownFix incorrect
Transitionboundary forDialogcomponent
2.1.0
21 Jun 2024Add ability to render multiple
Dialogcomponents at once (without nesting them)
Headless UI v2.1
We just released Headless UI v2.1 for React, which dramatically simplifies our transition APIs and adds support for rendering multiple dialogs as siblings. See our announcement blog to learn more.
Changelog
Added
Add ability to render multiple
Dialogcomponents at once (without nesting them)Add new data-attribute-based transition API (#3273, #3285, #3307, #3309, #3312)
Add
PopoverBackdropcomponent to replacePopoverOverlay
Fixed
Keep
Comboboxopen when clicking scrollbar inComboboxOptionsEnsure
ComboboxInputdoes not sync with current value while typingFix visual jitter in
Comboboxcomponent when using native scrollbarImprove UX by freezing
ComboboxOptionswhile closingMerge incoming
styleprop onComboboxOptions,ListboxOptions,MenuItems, andPopoverPanelcomponentsPrevent focus on
Checkboxwhen it isdisabledUse
useIdinstead of React internals (for React 19 compatibility)Cancel outside click behavior on touch devices when scrolling
Correctly apply conditional classes when using
TransitionandTransitionChildcomponents
Changed
Allow using the
TabandShift+Tabkeys when theListboxcomponent is open
2.0.4
24 May 2024- Deprecated
Mark
SwitchGroupas deprecated, preferFieldinstead Don’t set a focus fallback for Dialog’s in demo mode
Ensure page doesn't scroll down when pressing
Escapeto close theDialogcomponent
Fixed
Don’t set a focus fallback for Dialog’s in demo mode
Ensure page doesn't scroll down when pressing
Escapeto close theDialogcomponentFix crash when toggling between
virtualand non-virtual mode inComboboxcomponentEnsure tabbing to a portalled
PopoverPanelcomponent moves focus inside (without usingPortalGroup)Only handle form reset when
defaultValueis used
Deprecated
- Deprecated
Mark
SwitchGroupas deprecated, preferFieldinstead
Changed
Use native
fieldsetinstead ofdivby default forFieldsetcomponent
2.0.3
7 May 2024Make sure disabling demo mode on
Comboboxworks
2.0.2
7 May 2024Improve performance of internal
useInertOthershook
2.0.1
6 May 2024Remove accidental deprecation comments on
DialogPanelandDialogTitle
2.0.0
6 May 2024- Deprecated
Deprecate the
RadioGroup.Optioncomponent in favor of newRadiocomponent - Deprecated
Deprecate the
activeprop in favor of newfocusprop
We just released Headless UI v2.0 for React which includes a ton of new stuff:
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.Headless checkbox component — we've added a headless
Checkboxcomponent to complement our existingRadioGroupcomponent, making it easy to build totally custom checkbox controls.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.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.Combobox list virtualization — the
Comboboxcomponent can now handle giant lists of options with no performance issues.
Changelog
Added
Add new
ButtoncomponentAdd new
FieldsetandLegendcomponentsAdd new
MenuSection,MenuHeading, andMenuSeparatorcomponentsAdd new
ListboxSelectedOptioncomponentAdd new
DataInteractivecomponentAdd new
CloseButtoncomponent anduseClosehookAdd new
anchor,modal, andportalprops toCombobox,Listbox,MenuandPopovercomponents (#2887, #3075, #3097, #3111, #3115, #3121, #3124, #3133, #3138, #3148, #3152, #3154, #3157)Add new
autoFocusprop to focusable componentsAdd new
virtualprop toComboboxcomponent (#2779, #3128, #3160, #3161, #3163)Add new
onCloseprop toComboboxcomponentAdd new
immediateprop toComboboxfor immediately opening the Combobox when theinputreceives focusAdd new
--button-widthCSS variable on theListboxOptions,MenuItems, andPopoverPanelcomponents (#2887, #3058)Add new
--input-widthand--button-widthCSS variables on theComboboxOptionscomponentAdd new
data-*attributes as an alternative to the existingdata-headlessui-stateattribute (#2887, #3035, #3061)
Fixed
Fix scroll-locking on iOS
Fix cancellation of events when using
disabledoraria-disabledattributesFix unnecessary execution of the
displayValuecallback inComboboxInputcomponentFix types for
multipleprop inComboboxcomponentFix focus handling in
ComboboxInputcomponent (#3065, #3073)Fix enter transitions in
TransitioncomponentFix focus handling in
ListboxOptionsandMenuItemscomponentsFix horizontal scrolling inside the
Dialogcomponent
Changed
- Breaking
Always render hidden form input fields for
Checkbox,SwitchandRadioGroupcomponents- Deprecated
Deprecate the
RadioGroup.Optioncomponent in favor of newRadiocomponent - Deprecated
Deprecate the
activeprop in favor of newfocusprop Dialog is now focused by default instead of the first focusable element
Change default tags for
ListboxOptions,ListboxOption,ComboboxOptions,ComboboxOption, andTabGroupcomponentsChange default tag from
divtoFragmentonTransitioncomponents (#3110, #3147)Attempt form submission when pressing enter on the
ListboxButtoncomponent- Deprecated
Deprecate the
enteredprop on theTransitioncomponent Add frozen value to
ComboboxOptionscomponent
Upgrading from v1
Update dependencies
Install the latest version of the package via npm:
npm install @headlessui/react@latest
Default element changes
The default rendered element has changed for a number of components in v2.0:
Component v1.x element v2.0 element TransitiondivFragmentTransitionChilddivFragmentListboxOptionsuldivListboxOptionlidivComboboxOptionsuldivComboboxOptionlidivTabGroupFragmentdivIf you are using any of these components without the
asprop, you'll need to add theasprop and render the component with the element you need:- <Transition ...> + <Transition as="div" ...>
Comboboxes now always support empty values
Previously the
Comboboxcomponent required an option to always be set, and you could opt out of this behavior using thenullableprop. In v2.0 comboboxes support empty values by default so you can remove this prop:- <Combobox value={selected} onChange={setSelected} nullable> + <Combobox value={selected} onChange={setSelected}>If you'd like to keep the previous behavior, update your
onChangecallback to only set the selected value if an option has actually been selected:<Combobox value={selected} - onChange={setSelected} + onChange={(newValue) => setSelected((oldValue) => newValue ?? oldValue)} onClose={() => setQuery('')} >Dialogs no longer require a focusable child
Previously the
Dialogcomponent would automatically focus the first focusable child on open. This meant that you had to have at least one focusable element within your dialog, otherwise you would see a warning in your console.In v2.0 that is no longer the case and the dialog's root element is focused instead on open.
If you'd like a child element to receive focus when your dialog is opened, you can add the
autoFocusprop to any Headless UI form control:<Dialog> <DialogPanel> - <Listbox ... /> + <Listbox autoFocus ... /> </DialogPanel> </Dialog>
For non-Headless UI components, you can add the
data-autofocusattribute to any focusable element:<Dialog> <DialogPanel> - <button>...</button> + <button data-autofocus>...</button> </DialogPanel> </Dialog>
Dropdown components are now modal by default
The
Menu,Combobox, andListboxdropdowns are now rendered modal by default. When the dropdown is open the page is scroll-locked and all other page content is madeinert.While this is generally recommended behavior for these components, you can disable this using the
modalprop:- <ComboboxOptions ...> + <ComboboxOptions modal={false} ...>Dialog.OverlayandDialog.Backdropcomponents removedIn Headless UI v1.6 we deprecated the
Dialog.OverlayandDialog.Backdropcomponents. These have now been removed in v2.0.If you're using either of these components, you can update your app to use the new
DialogPanelapproach:<Dialog> - <Dialog.Overlay className="..." /> + <div className="..." /> + <DialogPanel> {/* ... */} + </DialogPanel> </Dialog>Deprecated component dot-notation
The previous component dot-notation has been deprecated in favor of using explicit imports for each individual component. This is to improve compatibility with RSC (React Server Components) and tree-shaking.
We recommend updating to this new API:
- import { Menu } from '@headlessui/react' + import { Menu, MenuButton, MenuItems, MenuItem } from '@headlessui/react' function Example() { return ( <Menu> - <Menu.Button>My account</Menu.Button> - <Menu.Items> - <Menu.Item><a href="/settings">Settings</a></Menu.Item> - <Menu.Item><a href="/support">Support</a></Menu.Item> - <Menu.Item><a href="/license">License</a></Menu.Item> - </Menu.Items> + <MenuButton>My account</MenuButton> + <MenuItems> + <MenuItem><a href="/settings">Settings</a></MenuItem> + <MenuItem><a href="/support">Support</a></MenuItem> + <MenuItem><a href="/license">License</a></MenuItem> + </MenuItems> </Menu> ) }Deprecated component-specific label and description components
With the addition of the multi-purpose
Field,LabelandDescriptioncomponents in v2, we've deprecated the component-specific versions.v1.x component v2.0 replacement Combobox.LabelLabelDialog.DescriptionDescriptionListbox.LabelLabelRadioGroup.DescriptionDescriptionRadioGroup.LabelLabelSwitch.DescriptionDescriptionSwitch.GroupFieldSwitch.LabelLabelWe recommend updating to these new components:
- import { Combobox } from '@headlessui/react' + import { Combobox, ComboboxInput, ComboboxOptions, Field, Label } from '@headlessui/react' function Example() { return ( - <Combobox> - <Combobox.Label>Assignee:</Combobox.Label> - <Combobox.Input /> - <Combobox.Options>{/* ... */}</Combobox.Options> - </Combobox> + <Field> + <Label>Assignee:</Label> + <Combobox> + <ComboboxInput /> + <ComboboxOptions>{/* ... */}</ComboboxOptions> + </Combobox> + <Field> ) }Deprecated
RadioGroup.OptioncomponentWe've deprecated the
RadioGroup.Optionin favor of the more terseRadiocomponent.We recommend updating to this new component:
<RadioGroup> - <RadioGroup.Option>{*/ ...*/}</RadioGroup.Option> + <Radio>{*/ ...*/}</Radio> </RadioGroup>We've also changed the default tag from
divtospan.Deprecated
activeprop in favor offocusWe've deprecated the
activeprop in favor of the newfocusprop on theComboboxOption,ListboxOption,ListboxOption,MenuItem,MenuItem,RadioOption, andRadioOptioncomponents.We recommend updating to this new prop:
<MenuItem > - {({ active }) => ( + {({ focus }) => ( {/* ... */} )} </MenuItem>Deprecated
@headlessui/tailwindcsspackageWith the availability of the new
data-*attributes in v2.0, we've deprecated the@headlessui/tailwindcsspackage.We recommend updating to use the new
data-*attributes instead. Start by removing this package:npm remove @headlessui/tailwindcss
Next, replace the
ui-*class modifiers withdata-[*]modifiers:<MenuItem as="a" href="#" - className="ui-active:bg-blue-500 ui-active:text-white" + className="data-[active]:bg-blue-500 data-[active]:text-white" > {*/ ...*/} </MenuItem>- 1.x
1.7.19
15 Apr 2024Make sure panels re-register when IDs are calculated in React < 18
Expose
disabledstate onTabcomponentPrevent default behaviour when clicking outside of a
Dialog.Panel
Fixed
Make sure panels re-register when IDs are calculated in React < 18
Expose
disabledstate onTabcomponentPrevent default behaviour when clicking outside of a
Dialog.PanelAdd
hiddenattribute to internalHiddencomponent when theFeatures.Hiddenfeature is usedAllow setting custom
tabIndexon theSwitchcomponentForward
disabledstate to hidden inputs in form-like componentsRespect
selectedIndexfor controlledTabcomponents
1.7.18
8 Jan 2024Don't call
<Dialog>'sonClosetwice on mobile devicesLazily resolve default containers in
<Dialog>Ensure hidden
Tab.Panelcomponents are hidden from the accessibility tree
Fixed
Don't call
<Dialog>'sonClosetwice on mobile devicesLazily resolve default containers in
<Dialog>Ensure hidden
Tab.Panelcomponents are hidden from the accessibility treeAdd support for
role="alertdialog"to<Dialog>componentEnsure blurring the
Combobox.Inputcomponent closes theComboboxAllow changes to the
classNameprop when the<Transition />component is currently not transitioningExport (internal-only) component interfaces for TypeScript compiler
Fix infinite render-loop for
<Disclosure.Panel>and<Popover.Panel>whenas={Fragment}Fix VoiceOver bug for
Listboxcomponent in ChromeFix outside click detection when component is mounted in the Shadow DOM
Fix CJS types
Fix error when transition classes contain new lines
Improve iOS locking
1.7.17
17 Aug 2023Use correct value when resetting
<Listbox multiple>and<Combobox multiple>Render
<MainTreeNode />inPopover.Groupcomponent onlyDisable smooth scrolling when opening/closing
Dialogcomponents on iOS
Fixed
Use correct value when resetting
<Listbox multiple>and<Combobox multiple>Render
<MainTreeNode />inPopover.Groupcomponent onlyDisable smooth scrolling when opening/closing
Dialogcomponents on iOSDon't assume
<Tab />components are available when setting the next indexFix incorrectly focused
Combobox.Inputcomponent on page loadEnsure
appearworks using theTransitioncomponent (even when used with SSR)Improve resetting values when using the
nullableprop on theComboboxcomponentFix hydration of components inside
<Suspense>Prevent scrolling when focusing a tab
1.7.16
27 Jul 2023Ensure the caret is in a consistent position when syncing the
Combobox.InputvalueImprove "outside click" behaviour in combination with 3rd party libraries
Ensure IME works on Android devices
Fixed
Ensure the caret is in a consistent position when syncing the
Combobox.InputvalueImprove "outside click" behaviour in combination with 3rd party libraries
Ensure IME works on Android devices
Calculate
aria-expandedpurely based on the open/closed stateSubmit form on
Entereven if no submit-like button was found
1.7.15
1 Jun 2023Add demo mode to
MenuandPopovercomponentsEnsure
FocusTrapis only active when the givenenabledvalue istrueStop
<Transition appear>from overwriting classes on re-render
Added
Add demo mode to
MenuandPopovercomponents
Fixed
Ensure
FocusTrapis only active when the givenenabledvalue istrueStop
<Transition appear>from overwriting classes on re-renderImprove control over
MenuandListboxoptions while searchingConsider clicks inside iframes to be "outside"
Ensure moving focus within a
Portalcomponent, does not close thePopovercomponent
Changed
Move
typescondition to the front
1.7.14
12 Apr 2023Fix focus styles showing up when using the mouse
Fix "Can't perform a React state update on an unmounted component." when using the
TransitioncomponentAdd
FocusTrapevent listeners once document has loaded
Fixed
Fix focus styles showing up when using the mouse
Fix "Can't perform a React state update on an unmounted component." when using the
TransitioncomponentAdd
FocusTrapevent listeners once document has loadedFix
classNamehydration for<Transition appear>Improve
Comboboxtypes to improve false positivesMerge
classNamecorrectly when it’s a function
Added
Add
formprop to form-like components such asRadioGroup,Switch,Listbox, andCombobox
1.7.13
3 Mar 2023Ensure
Transitioncomponent completes if nothing is transitioningEnable native label behavior for
<Switch>where possibleAllow root containers from the
Dialogcomponent in theFocusTrapcomponent
Fixed
Ensure
Transitioncomponent completes if nothing is transitioningEnable native label behavior for
<Switch>where possibleAllow root containers from the
Dialogcomponent in theFocusTrapcomponentFix
XYZPropsWeControland cleanup internal TypeScript typesFix invalid warning when using multiple
Popover.Buttoncomponents inside aPopover.PanelFix restore focus to buttons in Safari, when
Dialogcomponent closes
1.7.12
24 Feb 2023Add explicit props types for every component
Ensure the main tree and parent
Dialogcomponents are marked asinertFix nested
Popovercomponents not opening
Added
Add explicit props types for every component
Fixed
Ensure the main tree and parent
Dialogcomponents are marked asinertFix nested
Popovercomponents not openingMake React types more compatible with other libraries
Fix
Dialogcleanup when theDialogbecomes hidden
1.7.11
15 Feb 2023Ensure we handle
nullvalues for thedataRefcorrectlyMove
aria-multiselectableto[role=listbox]in theComboboxcomponentRe-focus
Combobox.Inputwhen aCombobox.Optionis selected
Fixed
Ensure we handle
nullvalues for thedataRefcorrectlyMove
aria-multiselectableto[role=listbox]in theComboboxcomponentRe-focus
Combobox.Inputwhen aCombobox.Optionis selectedEnsure we reset the
activeOptionIndexif the active option is unmountedImprove
Reftype for forwardedSwitch's refStart cleanup phase of the
Dialogcomponent when going into theClosingstate
1.7.10
6 Feb 2023Revert "Use the
import * as React from 'react'pattern
1.7.9
3 Feb 2023Fix SSR tab hydration when using Strict Mode in development
Don't break overflow when multiple dialogs are open at the same time
Fix "This
Suspenseboundary received an update before it finished hydrating" error in theDisclosurecomponent
Fixed
Fix SSR tab hydration when using Strict Mode in development
Don't break overflow when multiple dialogs are open at the same time
Fix "This
Suspenseboundary received an update before it finished hydrating" error in theDisclosurecomponentUse the
import * as React from 'react'pattern
1.7.8
27 Jan 2023Fix SSR tab rendering on React 17
Fix arrow key handling in
Tab(after DOM order changes)Fix false positive warning about using multiple
<Popover.Button>components
Fixed
Fix SSR tab rendering on React 17
Fix arrow key handling in
Tab(after DOM order changes)Fix false positive warning about using multiple
<Popover.Button>componentsFix
Tabkey with non focusable elements inPopover.PanelFix false positive warning when using
<Popover.Button />in React 17Fix
failed to removeChild on NodebugDon’t overwrite classes during SSR when rendering fragments
Improve
ComboboxaccessibilityFix crash when reading
headlessuiFocusGuardofrelatedTargetin theFocusTrapcomponentFix
FocusTrapinDialogwhen there is only 1 focusable elementImprove
Tabswrapping around when controlling the component and overflowing theselectedIndexFix
shadow-rootbug closingDialogcontainers
Added
Allow setting
tabIndexon theTab.Panel
1.7.7
16 Dec 2022Improve scroll restoration after
Dialogcloses
1.7.6
15 Dec 2022Fix regression where
displayValuecrashesFix
displayValuesyncing whenCombobox.Inputis unmounted and re-mounted in different treesFix FocusTrap escape due to strange tabindex values
1.7.5
8 Dec 2022Reset form-like components when the parent
<form>resetsAdd warning when using
<Popover.Button />multiple timesEnsure Popover doesn't crash when
focusis going towindow
Fixed
Reset form-like components when the parent
<form>resetsAdd warning when using
<Popover.Button />multiple timesEnsure Popover doesn't crash when
focusis going towindowEnsure
shift+homeandshift+endworks as expected in theCombobox.InputcomponentImprove syncing of the
Combobox.InputvalueFix crash when using
multiplemode withoutvalueprop (uncontrolled) forListboxandComboboxcomponentsApply
enterandenterFromclasses in SSR forTransitioncomponentAllow passing in your own
idpropFix
Dialogunmounting problem due to incorrecttransitioncancelevent in theTransitioncomponent on AndroidIgnore pointer events in Listbox, Menu, and Combobox when cursor hasn't moved
Allow clicks inside dialog panel when target is inside shadow root
1.7.4
3 Nov 2022Fix
<Popover.Button as={Fragment} />crashExpose
closefunction forMenuandMenu.ItemcomponentsFix
useOutsideClick, add improvements for ShadowDOM
Fixed
Fix
<Popover.Button as={Fragment} />crashExpose
closefunction forMenuandMenu.ItemcomponentsFix
useOutsideClick, add improvements for ShadowDOMFire
<Combobox.Input>'sonChangehandler when changing the value internallyAdd
client-onlyto mark everything as client components
Added
Warn when changing components between controlled and uncontrolled
1.7.3
30 Sep 2022Improve
Portaldetection forPopovercomponentsFix
useOutsideClickswallowing events inside ShadowDOMFix
Tabincorrectly activating onfocusevent
1.7.2
15 Sep 2022Prevent option selection in
Combobox.Inputwhile composingEnsure we handle the
staticprop inTab.Panelcomponents correctly
1.7.1
12 Sep 2022- Removed
Remove
forceRerenderfromTabcomponent Improve iOS scroll locking
Add
<fieldset disabled>check to radio group options in React
Fixed
Improve iOS scroll locking
Add
<fieldset disabled>check to radio group options in ReactEnsure
Taborder stays consistent, and the currently activeTabstays activeEnsure
Combobox.Labelis properly linked when rendered afterCombobox.ButtonandCombobox.Inputcomponents- Removed
Remove
forceRerenderfromTabcomponent
1.7.0
6 Sep 2022Make form components uncontrollable
Add
@headlessui/tailwindcssplugin
Added
Add
byprop forListbox,ComboboxandRadioGroup(#1482, #1717, #1814, #1815)Make form components uncontrollable
Add
@headlessui/tailwindcssplugin
Fixed
Fixed SSR support on Deno
Don’t close dialog when opened during mouse up event
Don’t close dialog when drag ends outside dialog
Fix outside clicks to close dialog when nested, unopened dialogs are present
Close
Menucomponent when usingtabkeyEnsure controlled
Tabsdon't change automagicallyDon't scroll lock when a Transition + Dialog is mounted but hidden
Allow
Popovercloseto be passed directly toonClickhandlersImprove outside click on Safari iOS
Improve event handler merging
Fix incorrect scrolling to the bottom when opening a
DialogImprove
Comboboxre-opening keyboard issue on mobileEnsure
Disclosure.Panelis properly linkedOnly select the active option when using "singular" mode when pressing
<tab>in theComboboxcomponentImprove the types of the
ComboboxcomponentOnly restore focus to the
Menu.Buttonif necessary when activating aMenu.OptionDon't scroll when wrapping around in focus trap
Fix
Transitioncomponent's incorrect cleanup and order of eventsEnsure enter transitions work when using
unmount={false}Improve accessibility when announcing
Listbox.OptionandCombobox.OptioncomponentsFix
refstealing from childrenExpose the
valuefrom theComboboxandListboxcomponents render propImprove
scroll lockon iOSFix maximum call stack size exceeded error on
Tabcomponent when usingas={Fragment}Fix "blank" screen on initial load of
Transitioncomponent
1.6.6
7 Jul 2022Ensure
CMD+Backspaceworks in nullable mode forComboboxcomponent
1.6.5
20 Jun 2022Fix incorrect transitionend/transitioncancel events for the Transition component
Improve outside click of
DialogcomponentDetect outside clicks from within
<iframe>elements
Fixed
Fix incorrect transitionend/transitioncancel events for the Transition component
Improve outside click of
DialogcomponentDetect outside clicks from within
<iframe>elementsImprove Combobox input cursor position
Fix scrolling issue in
Tabcomponent when using arrow keys
1.6.4
29 May 2022Ensure
Escapepropagates correctly inComboboxcomponentRemove leftover code in Combobox component
Fix event handlers with arity > 1
Fixed
Ensure
Escapepropagates correctly inComboboxcomponentRemove leftover code in Combobox component
Fix event handlers with arity > 1
Fix transition
enterbugFix render prop data in
RadioGroupcomponent
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.