Headless UI

Fixed

• Don’t render <Portal> while hydrating (#3825)
• Fix passing props on Fragment error due to Symbol(react.lazy) (#3873)

Fixed

• Improve focus management in shadow DOM roots (#3794)
• Don't accidentally open the Combobox when touching the ComboboxButton while dragging on mobile (#3795)
• Ensure sibling Dialog components are scrollable on mobile (#3796)
• Infer Combobox type based on onChange handler (#3798)
• Allow home/end key default behavior inside ComboboxInput when Combobox is closed (#3798)
• Ensure interacting with a Dialog on iOS works after interacting with a disallowed area (#3801)
• Freeze Listbox values as soon as a value is selected (#3802)
• Ensure refs are forwarded when freezing data (#3390)
• Do not serialize React components into form fields (49e9e8e)

Fixed

• Ensure we are not freezing data when the static prop is used (#3779)
• Ensure onChange types are contravariant instead of bivariant (#3781)
• Support <summary> as a focusable element inside <details> (#3389)
• Fix Maximum update depth exceeded crash when using transition prop (#3782)
• Ensure pressing Tab in the ComboboxInput, correctly syncs the input value (#3785)
• Ensure --button-width and --input-width have the latest value (#3786)
• Fix 'Invalid prop data-headlessui-state supplied to React.Fragment' warning (#3788)
• Ensure element in ref callback is always connected when rendering in a Portal (#3789)
• Ensure form state is up to date when using uncontrolled components (#3790)
• Ensure data-open on ComboboxInput is up to date (#3791)
• Ensure changing the immediate prop value on the Combobox component works as expected (#3792)

Fixed

• Fix incorrect double invocation of menu items, listbox options and combobox options (#3766)
• Fix memory leak in SSR environment (#3767)
• Ensure programmatic .click() on MenuButton ref works (#3768)
• Don't activate hovered items while using the keyboard (#3769)

Fixed

• Fix immediately closing Listbox by requiring some cursor movement (#3762)

Fixed

• Fix listbox closing immediately after opening on touch devices (#3755)

Fixed

• Fix Combobox error (unexpected undefined) when using virtual mode (#3734)

Added

• Add a quick trigger action to the Menu, Listbox and Combobox components (#3700)

Fixed

• Fix clicking Label component should open <Input type="file"> (#3707)
• Ensure clicking on interactive elements inside Label component works (#3709)
• Fix focus not returned to SVG Element (#3704)
• Fix Listbox not focusing first or last option on ArrowUp / ArrowDown (#3721)
• Performance improvement: only re-render top-level component when nesting components e.g.: Menu inside a Dialog (#3722)
• Fix closing Menu when other Menu is opened (#3726)

Fixed

• Improve Menu component performance (#3685)
• Improve Listbox component performance (#3688)
• Improve Combobox component performance (#3697)
• Open Menu and Listbox on mousedown (#3689)
• Fix Transition component from incorrectly exposing the Closing state (#3696)

Added

• Accept tabIndex on the Checkbox component (#3645)
• Accept tabIndex on the RadioGroup component (#3646)

Fixed

• Use correct ownerDocument when using internal Portal component (#3594)
• Bump @tanstack/react-virtual to fix warnings in React 19 projects (#3588)
• Fix aria-invalid attributes to have a valid 'true' value (#3639)
• Add missing invalid prop to Combobox component (#3677)
• Fix Unexpected undefined crash in Combobox component with virtual mode (#3678)

• Support installing with Tailwind CSS v4 (#3634)

Added

• Add React 19 support (#3543)

Fixed

• Use React.JSX instead of deprecated global JSX (#3511)
• Fix crash in ListboxOptions when using as={Fragment} (#3513)

Fixed

• Ensure Element is available before polyfilling to prevent crashes in non-browser environments (#3493)
• Fix crash when using instanceof HTMLElement in some environments (#3494)
• Cleanup process in Combobox component when using virtualization (#3495)

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

• 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

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

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)