SuperAPI AI 工具集

tailwind-v4-best-practices

前端与建站

查看项目

更新于 10-15 22:41

技能介绍

该技能用于指导编写生产级 Tailwind CSS v4 代码,核心是设计系统思维、可维护性与性能。

主要原则:使用语义化设计令牌而非默认调色板,便于换肤;优先使用内置工具类而非任意值;只写完整类名,因为编译器需在构建时识别,不能动态拼接;避免 @apply,v4 不推荐,需要自定义组件类时可在 CSS 中用 theme()。

配置方式:v4 将配置从 JavaScript 移到 CSS,通过 @import "tailwindcss"; 与 @theme 定义令牌,例如 --color-primary、--color-background、--font-family-heading 等。颜色默认使用 OKLCH,格式为 oklch(lightness chroma hue / alpha)。

迁移:v3 到 v4 有类名重命名,如 bg-gradient-to-r 改为 bg-linear-to-r、flex-shrink-0 改为 shrink-0、flex-grow 改为 grow、decoration-clone 改为 box-decoration-clone、decoration-slice 改为 box-decoration-slice;可运行 npx @tailwindcss/upgrade 自动升级。

集成:Vite 中引入 @tailwindcss/vite 插件即可,v4 自动检测内容,无需配置 content 路径,生产环境自动 tree-shaking 未使用工具类。

参考资料按需加载:design-tokens.md 用于令牌架构与状态色;theming.md 用于暗色模式与运行时换肤;advanced-patterns.md 用于动画、网格、容器查询、自定义工具类与性能;migration.md 用于 v3 迁移。具体安装与完整用法以官方资料为准,本资料未提供更多细节。