SuperAPI AI 工具集

shadcn-ui

通用与其它

查看项目

更新于 10-15 22:39

技能介绍

用途:本技能面向使用 shadcn/ui 构建前端应用的开发者,提供组件发现、集成与定制的专家指导。shadcn/ui 不是传统组件库,而是把可复用组件复制进项目代码库的集合,基于 Radix UI 或 Base UI 与 Tailwind CSS,强调完全所有权、自由定制、无版本锁定与零运行时开销。

主要能力:浏览组件目录与 Registry Directory;查看组件元数据、依赖与示例;通过 get_component 获取源码手动集成;列出、查看与搜索自定义 Registry 中的组件;列举与获取 UI Blocks(如 calendar、dashboard、login、sidebar、products 等类别);指导主题定制、变体与组件扩展。

使用方式:新项目用 npx shadcn@latest create 初始化;已有项目用 npx shadcn@latest init 生成 components.json,配置 style、baseColor、cssVariables、Tailwind 路径、别名、rsc、rtl 等。添加组件推荐执行 npx shadcn@latest add [component-name],会下载源码、安装依赖、放入 components/ui/ 并更新配置。也可用 get_component 取源码,自行创建 components/ui/[component-name].tsx 并手动安装依赖。依赖包括 React 18+、Tailwind CSS 3.0+、Radix UI 或 Base UI、class-variance-authority、clsx、tailwind-merge。组件使用 cn() 合并类名,变体用 cva 管理,扩展组件应放在 components/ 而非 components/ui/。

适用场景与限制:适用于 React/Tailwind 项目的界面开发、主题定制、Blocks 搭建与可访问性维护;定制时需保留 ARIA 属性、键盘处理与焦点流。常见问题涉及别名配置、Tailwind 配置、依赖缺失与版本兼容;shadcn/ui v4 需要 React 18+,若使用 Next.js 需 13+。文档未提供具体收费与价格信息。