* remove raw `document.getElementById` calls When we introduced the `forwardRef` for all components, we also made sure that internal `ref`s were used to keep track of the actual DOM node. This code prefers the `internalXXRef` refs in favor of the `document.getElementById` calls. This is way more React-ish, and also fixes a few issues: - Potential performance improvements (no need to re-query the DOM, since we already have a reference to the DOM node). Note: this is a *guess*, I didn't measure this. - It could be that the element is rendered in another `document`, the correct would involve something like `someDOMNode.ownerDocument.getElementById(...)` but that should not be necessary anymore now. * make Disclosure implementation between React & Vue consistent * use a similar convention for DOM refs to other components * update changelog
Headless UI
A set of completely unstyled, fully accessible UI components, designed to integrate beautifully with Tailwind CSS.
Documentation
For full documentation, visit headlessui.dev.
Installing the latest version
You can install the latest version by using:
npm install @headlessui/react@latestoryarn add @headlessui/react@latest.npm install @headlessui/vue@latestoryarn add @headlessui/vue@latest.
Installing the insiders version
You can install the insiders version (which points to whatever the latest commit on the main branch is) by using:
npm install @headlessui/react@insidersoryarn add @headlessui/react@insiders.npm install @headlessui/vue@insidersoryarn add @headlessui/vue@insiders.
Note: The insiders build doesn't follow semver and therefore doesn't guarantee that the APIs will be the same once they are released.
Packages
| Name | Version | Downloads |
|---|---|---|
@headlessui/react |
||
@headlessui/vue |
Community
For help, discussion about best practices, or any other conversation that would benefit from being searchable:
For casual chit-chat with others using the library:
Join the Tailwind CSS Discord Server
Contributing
If you're interested in contributing to Headless UI, please read our contributing docs before submitting a pull request.