SuperAPI AI 工具集

tailwind-v4

前端与建站

查看项目

更新于 10-15 17:19

技能介绍

用途:本技能面向 Tailwind CSS v4,帮助完成项目搭建、主题变量定义、OKLCH 颜色使用与配置迁移,核心是 CSS 优先配置,不再依赖 tailwind.config.js。

主要能力:提供 Vite 插件接入方式,在 vite.config.ts 中引入 @tailwindcss/vite 并注册插件;CSS 入口使用 @import 'tailwindcss';通过 @theme 指令定义设计令牌,如 --color-primary、--color-surface、--spacing、--font-display、--breakpoint-lg、--animate-fade-in 等。@theme 支持 default、inline、reference 三种模式:default 生成可被引用的 CSS 变量,inline 直接内联值以减少变量开销,reference 以内联回退值方式提供而不输出 :root 变量。颜色默认采用 OKLCH 格式 oklch(L% C H),L 为 0%–100% 明度,C 为色度,H 为 0–360 色相。

与 v3 差异:配置从 tailwind.config.js 改为 CSS 中的 @theme;构建工具从 PostCSS 插件改为 @tailwindcss/vite;颜色默认从 rgb()/hsl() 改为 oklch();主题扩展从 JS 的 extend 改为 CSS 变量;暗色模式从配置项改为 CSS 变体。

使用方式:安装 tailwindcss、@tailwindcss/vite,按需加入 @types/node 与 vite;在 Vite 配置中注册插件,在 CSS 中导入并编写 @theme 块。常见模式包括两层变量系统(设计令牌加语义映射)、自定义字体(含 font-variation-settings 与 font-feature-settings)、动画关键帧。

适用场景:新建 Tailwind v4 项目、从 v3 迁移、需要动态主题或语义化设计令牌的前端工程。

限制:资料未提供具体版本兼容范围、浏览器支持细节、完整迁移步骤与性能数据;实际效果需以官方文档和项目环境为准。