用途:HeroUI v3 是构建在 Tailwind CSS v4 与 React Aria Components 之上的 React 组件库,用于开发可访问、可定制的界面组件,如 Button、Modal、Form、Card 等。本技能面向 v3 版本,明确要求忽略 v2 的写法。
主要能力:提供复合式组件(如 Card.Header、Card.Title)、语义化变体(primary、secondary、tertiary、danger、ghost、outline)、基于 CSS 变量与 oklch 色彩空间的主题,以及 BEM 命名约定。v3 不再需要 Provider,动画改为纯 CSS,无需 framer-motion。
使用方式:安装命令为 curl -fsSL https://heroui.com/install | bash -s heroui-react,或 npm i @heroui/styles @heroui/react tailwind-variants。Next.js App Router 下还需安装 tailwindcss、@tailwindcss/postcss、postcss,并在 globals.css 中先 @import "tailwindcss",再 @import "@heroui/styles",同时配置 postcss.config.mjs。组件文档可通过 node scripts/list_components.mjs、node scripts/get_component_docs.mjs Button、node scripts/get_source.mjs Button、node scripts/get_styles.mjs Button、node scripts/get_theme.mjs、node scripts/get_docs.mjs 获取,也可直接访问对应 .mdx 文档。
适用场景:使用 HeroUI v3 开发 React UI,尤其是 Next.js App Router 项目。
限制:必须使用 Tailwind CSS v4,v3 不兼容 Tailwind v3;组件采用复合结构而非扁平 props;事件建议用 onPress 而非 onClick;样式导入顺序要求 Tailwind 在前、HeroUI 在后;实现前应先获取 v3 文档。资料未提供收费、价格与效果信息。