SuperAPI AI 工具集

headlessui-react

前端与建站

查看项目

更新于 10-16 03:17

技能介绍

用途:HeadlessUI React 为 React 提供完全无样式、可访问的 UI 组件,组件负责无障碍与交互逻辑,样式全部由使用者提供。资料称有 38 个示例可通过 MCP 获取。

主要能力:覆盖 Dialog、Menu、Listbox、Combobox、Switch、Disclosure、Popover、RadioGroup、Tabs、Transitions、Suspense 等。采用复合组件模式,父组件管理状态、子组件渲染 UI;支持 as 属性更换渲染元素,通过 data-[focus]、data-[selected]、data-[checked]、data-[open]、data-[disabled]、data-[closed] 等 data 属性表达状态。内置 Transition 组件与 transition 属性,使用 Floating UI 定位,anchor 支持 top/right/bottom/left 及 start/end 对齐,可用 anchor={{ to: 'bottom', gap: 4 }} 设置间距。自动处理 ARIA 属性、键盘导航、焦点管理、屏幕阅读器播报与点击外部关闭。

使用方式:安装 npm install @headlessui/react,图标可选 npm install @heroicons/react。通过 MCP 浏览示例:list_components(framework: "headlessui-react");获取代码:get_component(framework: "headlessui-react", category: "components", component_type: "dialog", variant: "dialog");搜索:search_components(query: "listbox", framework: "headlessui-react")。组件从 @headlessui/react 导入,配合 className 与 data 属性用 Tailwind 样式。支持受控(value/onChange)与非受控(defaultValue)用法;提供 name 时可与原生表单集成并渲染隐藏 input;MenuItem 等支持 disabled。

适用场景:需要自建设计系统、要求无障碍与键盘交互、使用 Tailwind 定制下拉、弹窗、标签页、开关等界面的 React 项目。

限制:资料未提供收费、价格、平台支持范围、性能数据或版本兼容信息;具体样式与动画需自行实现。