Packages

@headlessui/react

2.2.10 · 7 Apr 2026MIT10.3M / weekRepositoryHomepagenpmAtom feed

Your version

72 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 2.x · latest line
  2. 2.2.10

    7 Apr 2026
    • Don’t render <Portal> while hydrating

    • Fix passing props on Fragment error due to Symbol(react.lazy)

  3. 2.2.9

    25 Sep 2025
    • Improve focus management in shadow DOM roots

    • Don't accidentally open the Combobox when touching the ComboboxButton while dragging on mobile

    • Ensure sibling Dialog components are scrollable on mobile

  4. 2.2.8

    12 Sep 2025
    • Ensure we are not freezing data when the static prop is used

    • Ensure onChange types are contravariant instead of bivariant

    • Support <summary> as a focusable element inside <details>

  5. 2.2.7

    30 Jul 2025
    • Fix incorrect double invocation of menu items, listbox options and combobox options

    • Fix memory leak in SSR environment

    • Ensure programmatic .click() on MenuButton ref works

  6. 2.2.6

    24 Jul 2025
    • Fix immediately closing Listbox by requiring some cursor movement

  7. 2.2.5

    23 Jul 2025
    • Fix listbox closing immediately after opening on touch devices

  8. 2.2.4

    20 May 2025
    • Fix Combobox error (unexpected undefined) when using virtual mode

  9. 2.2.3

    12 May 2025
    • Add a quick trigger action to the Menu, Listbox and Combobox components

    • Fix clicking Label component should open <Input type="file">

    • Ensure clicking on interactive elements inside Label component works

  10. 2.2.2

    17 Apr 2025
    • Improve Menu component performance

    • Improve Listbox component performance

    • Improve Combobox component performance

  11. 2.2.1

    4 Apr 2025
    • Accept tabIndex on the Checkbox component

    • Accept tabIndex on the RadioGroup component

    • Use correct ownerDocument when using internal Portal component

  12. 2.2.0

    25 Oct 2024
    • Add React 19 support

  13. 2.1.10

    10 Oct 2024
    • Use React.JSX instead of deprecated global JSX

    • Fix crash in ListboxOptions when using as={Fragment}

  14. 2.1.9

    3 Oct 2024
    • Ensure Element is available before polyfilling to prevent crashes in non-browser environments

    • Fix crash when using instanceof HTMLElement in some environments

    • Cleanup process in Combobox component when using virtualization

  15. 2.1.8

    12 Sep 2024
    • Fix crash when using as={Fragment} on MenuButton, ListboxButton, DisclosureButton or Button components

  16. 2.1.7

    11 Sep 2024
    • Prevent crash in environments where Element.prototype.getAnimations is not available

  17. 2.1.6

    9 Sep 2024
    • Fix ListboxOptions being incorrectly marked as inert

    • Fix crash when using DisclosureButton inside of a DisclosurePanel when the Disclosure is open by default

  18. 2.1.5

    4 Sep 2024
    • Fix transition bug on Firefox, triggered by clicking the PopoverButton in rapid succession

  19. 2.1.4

    3 Sep 2024
    • Fix components not closing properly when using the transition prop

  20. 2.1.3

    23 Aug 2024
    • Ensure Transition component state doesn't change when it becomes hidden

    • Fix closing components using the transition prop, and after scrolling the page

    • Ensure all client components are marked correctly to avoid a crash with React 19 and Turbopack

  21. 2.1.2

    5 Jul 2024
    • Fix prematurely added anchoring styles on ListboxOptions

    • Ensure unmount on Dialog works in combination with the transition prop on DialogBackdrop and DialogPanel components

    • Fix crash in Combobox component when in virtual mode when options are empty

  22. 2.1.1

    26 Jun 2024
    • Fix issues spreading omitted props onto components

    • Fix initial anchor="selection" positioning

    • Fix render prop in ComboboxOptions to use any instead of unknown

  23. 2.1.0

    21 Jun 2024
    • Add ability to render multiple Dialog components at once (without nesting them)

    • Add new data-attribute-based transition API (#3273, #3285, #3307, #3309, #3312)

    • Add DialogBackdrop component (#3307, #3310)

  24. 2.0.4

    24 May 2024
    • Deprecated

      Mark SwitchGroup as deprecated, prefer Field instead

    • Don’t set a focus fallback for Dialog’s in demo mode

    • Ensure page doesn't scroll down when pressing Escape to close the Dialog component

  25. 2.0.3

    7 May 2024
    • Make sure disabling demo mode on Combobox works

  26. 2.0.2

    7 May 2024
    • Improve performance of internal useInertOthers hook

  27. 2.0.1

    6 May 2024
    • Remove accidental deprecation comments on DialogPanel and DialogTitle

  28. 2.0.0

    6 May 2024
    • Breaking

      Require React 18 (#2887, #3092, #3131)

    • Deprecated

      Deprecate the RadioGroup.Option component in favor of new Radio component

    • Deprecated

      Deprecate the active prop in favor of new focus prop

  29. 1.x
  30. 1.7.19

    15 Apr 2024
    • Make sure panels re-register when IDs are calculated in React < 18

    • Expose disabled state on Tab component

    • Prevent default behaviour when clicking outside of a Dialog.Panel

  31. 1.7.18

    8 Jan 2024
    • Don't call <Dialog>'s onClose twice on mobile devices

    • Lazily resolve default containers in <Dialog>

    • Ensure hidden Tab.Panel components are hidden from the accessibility tree

  32. 1.7.17

    17 Aug 2023
    • Use correct value when resetting <Listbox multiple> and <Combobox multiple>

    • Render <MainTreeNode /> in Popover.Group component only

    • Disable smooth scrolling when opening/closing Dialog components on iOS

  33. 1.7.16

    27 Jul 2023
    • Ensure the caret is in a consistent position when syncing the Combobox.Input value

    • Improve "outside click" behaviour in combination with 3rd party libraries

    • Ensure IME works on Android devices

  34. 1.7.15

    1 Jun 2023
    • Add demo mode to Menu and Popover components

    • Ensure FocusTrap is only active when the given enabled value is true

    • Stop <Transition appear> from overwriting classes on re-render

  35. 1.7.14

    12 Apr 2023
    • Fix focus styles showing up when using the mouse

    • Fix "Can't perform a React state update on an unmounted component." when using the Transition component

    • Add FocusTrap event listeners once document has loaded

  36. 1.7.13

    3 Mar 2023
    • Ensure Transition component completes if nothing is transitioning

    • Enable native label behavior for <Switch> where possible

    • Allow root containers from the Dialog component in the FocusTrap component

  37. 1.7.12

    24 Feb 2023
    • Add explicit props types for every component

    • Ensure the main tree and parent Dialog components are marked as inert

    • Fix nested Popover components not opening

  38. 1.7.11

    15 Feb 2023
    • Ensure we handle null values for the dataRef correctly

    • Move aria-multiselectable to [role=listbox] in the Combobox component

    • Re-focus Combobox.Input when a Combobox.Option is selected

  39. 1.7.10

    6 Feb 2023
    • Revert "Use the import * as React from 'react' pattern

  40. 1.7.9

    3 Feb 2023
    • 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 Suspense boundary received an update before it finished hydrating" error in the Disclosure component

  41. 1.7.8

    27 Jan 2023
    • 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> components

  42. 1.7.7

    16 Dec 2022
    • Improve scroll restoration after Dialog closes

  43. 1.7.6

    15 Dec 2022
    • Fix regression where displayValue crashes

    • Fix displayValue syncing when Combobox.Input is unmounted and re-mounted in different trees

    • Fix FocusTrap escape due to strange tabindex values

  44. 1.7.5

    8 Dec 2022
    • Reset form-like components when the parent <form> resets

    • Add warning when using <Popover.Button /> multiple times

    • Ensure Popover doesn't crash when focus is going to window

  45. 1.7.4

    3 Nov 2022
    • Fix <Popover.Button as={Fragment} /> crash

    • Expose close function for Menu and Menu.Item components

    • Fix useOutsideClick, add improvements for ShadowDOM

  46. 1.7.3

    30 Sep 2022
    • Improve Portal detection for Popover components

    • Fix useOutsideClick swallowing events inside ShadowDOM

    • Fix Tab incorrectly activating on focus event

  47. 1.7.2

    15 Sep 2022
    • Prevent option selection in Combobox.Input while composing

    • Ensure we handle the static prop in Tab.Panel components correctly

  48. 1.7.1

    12 Sep 2022
    • Removed

      Remove forceRerender from Tab component

    • Improve iOS scroll locking

    • Add <fieldset disabled> check to radio group options in React

  49. 1.7.0

    6 Sep 2022
  50. 1.6.6

    7 Jul 2022
    • Ensure CMD+Backspace works in nullable mode for Combobox component

  51. 1.6.5

    20 Jun 2022
    • Fix incorrect transitionend/transitioncancel events for the Transition component

    • Improve outside click of Dialog component

    • Detect outside clicks from within <iframe> elements

  52. 1.6.4

    29 May 2022
    • Ensure Escape propagates correctly in Combobox component

    • Remove leftover code in Combobox component

    • Fix event handlers with arity > 1

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.