Headless UI

Fixed

• Allow horizontal scrolling inside the Dialog component (#2889)
• Improve cancellation of events when using disabled or aria-disabled attributes (#2890)

Added

• Add immediate prop to <Combobox /> for immediately opening the Combobox when the input receives focus (#2686)
• Add virtual prop to Combobox component (#2779)
• Add new Checkbox component
• Add new Radio component as an alternative to the existing RadioGroup.Option component
• Add new Button component
• Add new Input component
• Add new Textarea component
• Add new Select component
• Add new Field, Label, Description, Fieldset and Legend components
• Add new DataInteractive component
• Add new anchor and modal prop to ComboboxOptions, ListboxOptions, MenuItems and PopoverPanel components
• Add new ListboxSelectedOption component
• Add new MenuSection, MenuHeading, and MenuSeparator components
• Add new simplified data-* attributes as an alternative to the existing data-headlessui-state="..." attribute
• Add autoFocus prop on focusable components (which maps to data-autofocus)

Changed

• Bumped to React and React DOM 18
• Dialog is focused by default instead of the first focusable element (unless an element exists with a data-autofocus in the dialog)

Fixed

• Don't call <Dialog>'s onClose twice on mobile devices (#2690)
• Lazily resolve default containers in <Dialog> (#2697)
• Ensure hidden Tab.Panel components are hidden from the accessibility tree (#2708)
• Add support for role="alertdialog" to <Dialog> component (#2709)
• Ensure blurring the Combobox.Input component closes the Combobox (#2712)
• Allow changes to the className prop when the <Transition /> component is currently not transitioning (#2722)
• Export (internal-only) component interfaces for TypeScript compiler (#2313)
• Fix infinite render-loop for <Disclosure.Panel> and <Popover.Panel> when as={Fragment} (#2760)
• Fix VoiceOver bug for Listbox component in Chrome (#2824)
• Fix outside click detection when component is mounted in the Shadow DOM (#2866)
• Fix CJS types (#2880)
• Fix error when transition classes contain new lines (#2871)
• Fix iOS scroll lock glitches

Fixed

• Fix form elements for uncontrolled <Listbox multiple> and <Combobox multiple> (#2626)
• Use correct value when resetting <Listbox multiple> and <Combobox multiple> (#2626)
• Render <MainTreeNode /> in PopoverGroup component only (#2634)
• Disable smooth scrolling when opening/closing Dialog components on iOS (#2635)
• Don't assume <Tab /> components are available when setting the next index (#2642)
• Improve SSR of the Disclosure component (#2645)
• Fix incorrectly focused ComboboxInput component on page load (#2654)
• Improve resetting values when using the nullable prop on the Combobox component (#2660)
• Prevent scrolling when focusing a tab (#2674)

Fixed

• Use correct value when resetting <Listbox multiple> and <Combobox multiple> (#2626)
• Render <MainTreeNode /> in Popover.Group component only (#2634)
• Disable smooth scrolling when opening/closing Dialog components on iOS (#2635)
• Don't assume <Tab /> components are available when setting the next index (#2642)
• Fix incorrectly focused Combobox.Input component on page load (#2654)
• Ensure appear works using the Transition component (even when used with SSR) (#2646)
• Improve resetting values when using the nullable prop on the Combobox component (#2660)
• Fix hydration of components inside <Suspense> (#2663)
• Prevent scrolling when focusing a tab (#2674)

Added

• Add ui-focus-visible variant to Tailwind plugin (#2347)
• Add ui-not-focus-visible variant to Tailwind plugin (#2618)

Fixed

• Ensure the caret is in a consistent position when syncing the Combobox.Input value (#2568)
• Improve "outside click" behaviour in combination with 3rd party libraries (#2572)
• Ensure IME works on Android devices (#2580)
• Calculate aria-expanded purely based on the open/closed state (#2610)
• Submit form on Enter even if no submit-like button was found (#2613)

Fixed

• Ensure the caret is in a consistent position when syncing the Combobox.Input value (#2568)
• Improve "outside click" behaviour in combination with 3rd party libraries (#2572)
• Improve performance of Combobox component (#2574)
• Ensure IME works on Android devices (#2580)
• Calculate aria-expanded purely based on the open/closed state (#2610)
• Submit form on Enter even if no submit-like button was found (#2613)

Added

• [internal] add demo mode to Menu and Popover components (#2448)

Fixed

• Ensure FocusTrap is only active when the given enabled value is true (#2456)
• Stop <Transition appear> from overwriting classes on re-render (#2457)
• Improve control over Menu and Listbox options while searching (#2471)
• Consider clicks inside iframes to be "outside" (#2485)
• Ensure moving focus within a Portal component, does not close the Popover component (#2492)

Changed

• Move types condition to the front (#2469)

Fixed

• Fix memory leak in Popover component (#2430)
• Ensure FocusTrap is only active when the given enabled value is true (#2456)
• Ensure the exposed activeIndex is up to date for the Combobox component (#2463)
• Improve control over Menu and Listbox options while searching (#2471)
• Consider clicks inside iframes to be "outside" (#2485)
• Ensure moving focus within a Portal component, does not close the Popover component (#2492)

Changed

• Move types condition to the front (#2469)

Fixed

• Fix focus styles showing up when using the mouse (#2347)
• Fix "Can't perform a React state update on an unmounted component." when using the Transition component (#2374)
• Add FocusTrap event listeners once document has loaded (#2389)
• Fix className hydration for <Transition appear> (#2390)
• Improve Combobox types to improve false positives (#2411)
• Merge className correctly when it’s a function (#2412)

Added

• Add form prop to form-like components such as RadioGroup, Switch, Listbox, and Combobox (#2356)

Fixed

• Fix focus styles showing up when using the mouse (#2347)
• Disable ComboboxInput when its Combobox is disabled (#2375)
• Add FocusTrap event listeners once document has loaded (#2389)
• Don't scroll-lock <Dialog> when wrapping transition isn't showing (#2422)
• Ensure DOM ref is properly handled in the RadioGroup component (#2424)

Added

• Add form prop to form-like components such as RadioGroup, Switch, Listbox, and Combobox (#2356)

Fixed

• Add ESM and types paths to package.json for Tailwind CSS plugin (#2382)

Fixed

• Ensure Transition component completes if nothing is transitioning (#2318)
• Enable native label behavior for <Switch> where possible (#2265)
• Allow root containers from the Dialog component in the FocusTrap component (#2322)
• Fix XYZPropsWeControl and cleanup internal TypeScript types (#2329)
• Fix invalid warning when using multiple Popover.Button components inside a Popover.Panel (#2333)
• Fix restore focus to buttons in Safari, when Dialog component closes (#2326)

Fixed

• Enable native label behavior for <Switch> where possible (#2265)
• Allow root containers from the Dialog component in the FocusTrap component (#2322)
• Cleanup internal TypeScript types (#2329)
• Fix restore focus to buttons in Safari, when Dialog component closes (#2326)
• Ensure hooks in the FocusTrap component only apply when mounted (#2331)

Added

• Add explicit props types for every component (#2282)

Fixed

• Ensure the main tree and parent Dialog components are marked as inert (#2290)
• Fix nested Popover components not opening (#2293)
• Make React types more compatible with other libraries (#2282)
• Fix Dialog cleanup when the Dialog becomes hidden (#2303)

Fixed

• Ensure the main tree and parent Dialog components are marked as inert (#2290)
• Fix nested Popover components not opening (#2293)
• Fix change event incorrectly getting called on blur (#2296)
• Fix Dialog cleanup when the Dialog becomes hidden (#2303)

Fixed

• Ensure we handle null values for the dataRef correctly (#2258)
• Move aria-multiselectable to [role=listbox] in the Combobox component (#2271)
• Re-focus Combobox.Input when a Combobox.Option is selected (#2272)
• Ensure we reset the activeOptionIndex if the active option is unmounted (#2274)
• Improve Ref type for forwarded Switch's ref (#2277)
• Start cleanup phase of the Dialog component when going into the Closing state (#2264)

Fixed

• Don’t fire afterLeave event more than once for a given transition (#2267)
• Move aria-multiselectable to [role=listbox] in the Combobox component (#2271)
• Re-focus Combobox.Input when a Combobox.Option is selected (#2272)
• Ensure we reset the activeOptionIndex if the active option is unmounted (#2274)
• Start cleanup phase of the Dialog component when going into the Closing state (#2264)

Fixed

• Revert "Use the import * as React from 'react' pattern (#2242)

Fixed

• Fix SSR tab hydration when using Strict Mode in development (#2231)
• Don't break overflow when multiple dialogs are open at the same time (#2215)
• Fix "This Suspense boundary received an update before it finished hydrating" error in the Disclosure component (#2238)
• Use the import * as React from 'react' pattern (#2242)