Fixed

• Fix crash when using as={Fragment} on MenuButton, ListboxButton, DisclosureButton or Button components (#3478)

Fixed

• Prevent crash in environments where Element.prototype.getAnimations is not available (#3473)

Fixed

• use native useId from Vue.js 3.5 when available (#3458)

Fixed

• Fix ListboxOptions being incorrectly marked as inert (#3466)
• Fix crash when using DisclosureButton inside of a DisclosurePanel when the Disclosure is open by default (#3465)

Fixed

• Fix transition bug on Firefox, triggered by clicking the PopoverButton in rapid succession (#3452)

Fixed

• Fix components not closing properly when using the transition prop (#3448)

Fixed

• Ensure Transition component state doesn't change when it becomes hidden (#3372)
• Fix closing components using the transition prop, and after scrolling the page (#3407)
• Ensure all client components are marked correctly to avoid a crash with React 19 and Turbopack (#3429)

Fixed

• Fix prematurely added anchoring styles on ListboxOptions (#3337)
• Ensure unmount on Dialog works in combination with the transition prop on DialogBackdrop and DialogPanel components (#3352)
• Fix crash in Combobox component when in virtual mode when options are empty (#3356)
• Fix hanging tests when using anchor prop (#3357)
• Fix transition and focus prop combination for PopoverPanel component (#3361)
• Fix outside click in nested portalled Popover components (#3362)
• Fix restoring focus to correct element when closing Dialog component (#3365)
• Fix flushSync warning for Combobox component with immediate prop enabled (#3366)

Fixed

• Fix issues spreading omitted props onto components (#3313)
• Fix initial anchor="selection" positioning (#3324)
• Fix render prop in ComboboxOptions to use any instead of unknown (#3327)
• Fix incorrect Transition boundary for Dialog component (#3331)

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 Dialog components at once (without nesting them) (#3242)
• Add new data-attribute-based transition API (#3273, #3285, #3307, #3309, #3312)
• Add DialogBackdrop component (#3307, #3310)
• Add PopoverBackdrop component to replace PopoverOverlay (#3308)

Fixed

• Keep Combobox open when clicking scrollbar in ComboboxOptions (#3249)
• Ensure ComboboxInput does not sync with current value while typing (#3259)
• Fix visual jitter in Combobox component when using native scrollbar (#3190)
• Improve UX by freezing ComboboxOptions while closing (#3304)
• Merge incoming style prop on ComboboxOptions, ListboxOptions, MenuItems, and PopoverPanel components (#3250)
• Prevent focus on Checkbox when it is disabled (#3251)
• Use useId instead of React internals (for React 19 compatibility) (#3254)
• Cancel outside click behavior on touch devices when scrolling (#3266)
• Correctly apply conditional classes when using Transition and TransitionChild components (#3303)

Changed

• Allow using the Tab and Shift+Tab keys when the Listbox component is open (#3284)