TL;DR

Headless UI now avoids hydration errors with portals and correctly passes props to Fragment components, improving stability for server-rendered applications.

Fixes Worth Knowing

• Resolved an issue where portals (overlay elements) could cause errors during initial page load in server-rendered apps.
• Fixed a bug preventing props from being correctly passed to Fragment components (lightweight container).

TL;DR

Headless UI now fully supports Tailwind CSS v4, enabling users to leverage the latest Tailwind features and performance improvements.

New

• Tailwind CSS v4 support: Upgrade to the newest Tailwind version for enhanced styling capabilities (CSS framework).

Before You Upgrade

Ensure you are using Tailwind CSS v4 to benefit from this update.

TL;DR

Headless UI now leverages Vue 3.5’s built-in useId (unique ID generator) for improved accessibility and performance.

Fixes Worth Knowing

• Resolved an issue where component IDs weren’t generated correctly, improving accessibility for screen readers and form labels.

Before You Upgrade

• Ensure you are using Vue 3.5 or later to benefit from the performance improvements of the native useId integration.

TL;DR

Headless UI components (Input, Select, Textarea) now correctly expose Ref types, improving compatibility with complex form integrations and custom component logic.

Breaking

• Ref types for Input, Select, and Textarea have been updated (may require adjustments to existing type definitions).

Fixes Worth Knowing

• Resolved an issue preventing proper referencing of Input, Select, and Textarea components.

Before You Upgrade

• Review and update any custom type definitions that rely on Ref types for Input, Select, or Textarea components.