SuperAPI AI 工具集

headless-ui

前端与建站

查看项目

更新于 10-16 00:29

技能介绍

用途:Headless UI 提供不带样式的可访问 UI 原语(primitives),面向 React 和 Vue,由 Tailwind CSS 团队维护,适合需要完全自定义视觉风格、同时希望获得无障碍与键盘交互能力的界面开发。安装命令为 npm install @headlessui/react。

主要能力:内置 Menu(下拉菜单)、Dialog(模态框)、Listbox(选择器)、Combobox(自动补全)、Switch(开关)、Tabs(标签页)等组件,并附带 MenuSection、MenuHeading、MenuSeparator、DialogTitle、Description、CloseButton、Field、Label 等辅助组件。组件通过 data 属性(如 data-[focus]、data-[selected]、data-[disabled]、data-[checked]、data-[closed])暴露内部状态供样式使用,也支持 render props 以编程方式读取 focus、disabled 等状态。支持 anchor 定位、内置 transition 过渡、Framer Motion 集成、表单隐藏输入与多选、以及自动的 ARIA 属性与键盘导航。

使用方式:从 @headlessui/react 导入组件并按文档组合使用,例如 Menu 配合 MenuButton、MenuItems、MenuItem 构建下拉菜单,Dialog 配合 DialogBackdrop、DialogPanel 构建模态框。用 Tailwind 的 data 修饰符或 CSS 选择器为不同状态编写样式;用 anchor 属性控制弹出位置;用 name 属性接入表单。

适用场景:需要自定义外观的下拉、模态、选择、自动补全、开关、标签页等交互组件,尤其是在 Tailwind CSS 项目中。

限制:资料未提供 Vue 的安装包名与具体示例、版本要求、收费或价格信息、性能与兼容性细节、以及各组件完整 API 列表,这些内容暂未提供。