SuperAPI AI 工具集

tailwindcss-v4

前端与建站

查看项目

更新于 10-26 16:22

技能介绍

用途

本技能聚焦 Tailwind CSS v4 的迁移与版本差异查询,适用于三类场景:将项目从 Tailwind v3 迁移到 v4;查阅 @theme 命名空间与自动生成工具类的对应关系;查找在 v3 中已被重命名或移除的工具类。资料明确说明,它不承担日常 CSS-first 配置参考(@theme/@utility/@variant 的常规使用由 tailwindcss-core 负责),也不做普通工具类查找。

版本概览

资料标注当前稳定版为 tailwindcss 4.3.3。v4.0 之后的小版本更新包括:v4.1 增加文字阴影、遮罩(masks);v4.2 增加 mauve/olive/mist/taupe 调色板、@tailwindcss/webpack、逻辑属性工具类 pbs/mbs/inline-/block-/inset-s|e|bs|be、font-features-,并弃用 start-/end-;v4.3 增加滚动条工具类、@container-size、zoom-、tab-*、堆叠与复合 @variant,以及功能型 @utility 中的 --default()。

主要能力

  1. @theme 命名空间速查:列出 --color-* 生成 bg-/text-/border-/fill- 等,--font-* 生成 font-,--text- 生成 text-xs/text-sm/text-base 等,--spacing-* 生成 p-/m-/gap-/w-/h-,--radius-* 生成 rounded-,--shadow- 生成 shadow-,--breakpoint- 生成 sm:/md:/lg:/xl: 等,--animate-* 与 --ease-* 对应动画和缓动工具类。

  2. v3 → v4 破坏性变更梳理:

  • 指令变化:v3 的 @tailwind base/components/utilities 改为 v4 的 @import "tailwindcss"。
  • 工具类重命名:shadow-sm→shadow-xs、shadow→shadow-sm、rounded-sm→rounded-xs、rounded→rounded-sm、outline-none→outline-hidden、ring→ring-3。
  • 移除的弃用工具类:bg-opacity-* 改用 bg-black/50 这类写法,text-opacity-* 改用 text-black/50,flex-shrink-* 改用 shrink-,flex-grow- 改用 grow-*。
  • 自定义工具类语法:v3 的 @layer utilities { .tab-4 { ... } } 改为 v4 的 @utility tab-4 { ... }。
  • 任意值中的变量写法:bg-[--brand-color] 改为 bg-(--brand-color)。
  • 重要修饰符位置:!bg-red-500 改为 bg-red-500!。
  1. 升级工具:提供命令 npx @tailwindcss/upgrade,要求 Node.js 20+。

  2. 详细参考文档入口:configuration.md 用于编写 CSS-first @theme 配置或使用 @utility/@variant/@custom-variant 指令;api-functions.md 用于 --alpha()/--spacing() CSS 函数或 @apply;installation-support.md 用于安装 Tailwind v4(npm/Vite/CLI/webpack)或查看浏览器支持。

使用方式

作为 Claude 插件技能按需加载:迁移项目或查改名/移除工具类时启用;具体主题配置、工具类与变体编写查阅 tailwindcss-core 与 tailwindcss-custom-styles。

适用场景

适合正在升级 Tailwind 版本、需要对照新旧类名和指令写法的前端项目,以及需要确认某个 v3 类在 v4 中对应名称的开发者。

限制

资料未提供该技能的安装方式、收费信息、支持平台与效果数据,这些内容暂未提供。它不覆盖日常配置参考与工具类查询,相关任务应参考其他技能。