Headless UI — это бесплатная библиотека компонентов без стилей от создателей Tailwind CSS: она даёт готовую логику, доступность и клавиатурное управление, а внешний вид вы задаёте сами.
Главное отличие — компоненты не навязывают дизайн. Вы получаете рабочие меню, диалоги и списки, а оформление пишете классами Tailwind.
Возможности
- Набор компонентов: Dialog, Menu, Listbox, Combobox, Popover, Tabs, Disclosure, Switch, Radio Group и поля форм.
- Доступность из коробки: ARIA-атрибуты, фокус, управление с клавиатуры.
- Анимации через компонент Transition и data-атрибуты состояний.
- Плавающие элементы: позиционирование выпадающих списков и поповеров с учётом края экрана.
- React и Vue: актуальная вторая версия — для React, Vue поддерживается в первой.
Кому подходит
Фронтенд-разработчикам на React и Tailwind, которые хотят свой дизайн без борьбы со стилями готовых UI-китов.
Как начать
Установите пакет командой npm install @headlessui/react, импортируйте нужный компонент и добавьте классы Tailwind. Готовые примеры оформления есть в Tailwind UI.
Совет
Используйте data-атрибуты состояний вроде data-focus и data-open вместо условных классов в JSX. Код станет короче, а стили — нагляднее.
Ограничения
Компонентов меньше, чем в Radix: нет тостов, тултипов, слайдеров и таблиц. Для Vue новые функции не выходят. Если нужен готовый дизайн, быстрее взять shadcn/ui или DaisyUI.