SuperAPI AI 工具集

converting-css-modules-to-tailwind

前端与建站

查看项目

更新于 10-16 02:08

技能介绍

用途

该技能用于把组件从 CSS Modules(.module.css / .module.scss)迁移到 Tailwind 工具类。它面向需要逐步去除 CSS Modules 间接层、改用 Tailwind 原子类的项目。

主要能力

  • 清点模块:读取 .module.css 文件及其导入组件,把每个 styles.xxx 引用映射到对应的 CSS 规则。
  • 逐类转换:将 styles.xxx 替换为等价的 Tailwind 工具类。
  • 处理 CSS Modules 特有模式:
    • composes 关键字:展平为单组工具类;如需复用则抽取组件而非类。
    • 使用 clsx/classnames 的条件类名:保留条件逻辑,替换为工具类字符串。
    • 动态类名选择(如 styles[variant]):改用查找对象映射到工具类。
    • :global 全局覆盖:迁移到 globals.css 的 @layer components { } 或使用 Tailwind 的 @apply。
    • SCSS 特性:嵌套选择器展平到各元素的工具类;$变量映射到 tailwind.config.ts 的 theme 值;mixin 替换为工具类组合或抽取组件。
  • 清理:移除 import styles 语句、删除 .module.css / .module.scss 文件、更新同目录 index.ts barrel 导出、搜索代码库中其他导入、运行应用并做视觉验证。

使用方式

按工作流逐步执行:先清点模块并映射引用,再逐类转换,然后处理 composes、条件类名、动态类名、:global 和 SCSS 等模式,最后清理并验证。规则要求一次只转换一个组件,不要批量处理整个目录;条件逻辑保留在 clsx() 或模板字符串中,不放进 CSS;伪元素样式需使用 before: / after: 前缀加 content-['...'];:nth-child、:first-of-type 等先检查 Tailwind 是否有匹配变体,否则保留最小 CSS 规则;不要用 @apply 类复刻原模块,目标是消除间接层。

适用场景

适用于使用 React 等组件框架、以 CSS Modules 组织样式、并希望迁移到 Tailwind 工具类的项目。示例中展示了 Card 组件从 .module.css 到 Tailwind 类的转换,以及 clsx 条件类名、variant 查找对象、composes 展平等常见场景。

限制

资料未提供该技能支持的框架范围、Tailwind 版本要求、自动化程度、安装命令、收费或价格信息,暂未提供。