SuperAPI AI 工具集

tailwindcss

前端与建站

查看项目

更新于 10-15 23:33

技能介绍

用途:在需要以工具类优先(utility-first)方式编写样式、构建响应式设计或配置 Tailwind 主题时使用。不适用于 MUI、纯 CSS 或复杂动画场景。

主要能力:使用工具类直接完成样式(如 bg-blue-500 hover:bg-blue-700 text-white font-bold py-2 px-4 rounded);通过断点前缀实现响应式(md:flex lg:grid);配置主题令牌(v3 用 tailwind.config.js 的 theme.extend,v4+ 用 @theme 块与 OKLCH);配置暗色模式(v3 在配置中启用,v4 用 @custom-variant dark);使用 CVA 处理组件变体;用 clsx/cn 处理条件样式。

使用方式:优先在 HTML 中直接使用工具类;共享组件模式才用 @apply,避免滥用;自定义颜色/间距加入主题而非硬编码十六进制;动态值用内联样式或任意值类(如 w-[137px]),但应尽量减少;确保 content 数组覆盖所有模板路径,避免生产构建类被清除。

限制与注意:工具类同优先级,HTML 顺序影响结果,慎用 !;第三方内联样式会覆盖,需用 !important 或包裹层;Tailwind 无法检测动态拼接的类名;@apply 过度使用会违背工具类优先原则。

补充资料:design-system.md 涉及令牌层级、语义命名、CVA 与暗色模式;tailwind-v4.md 涉及 v4 迁移、OKLCH 与 @theme。官方文档见 https://tailwindcss.com/docs,CVA 见 https://cva.style/docs,OKLCH 见 https://oklch.com/。