SuperAPI AI 工具集

material-ui-tailwind

前端与建站

查看项目

更新于 10-15 14:52

技能介绍

用途

本技能用于在同一个项目中同时使用 Material UI(MUI)与 Tailwind CSS,重点解决两者样式规则冲突的问题。典型触发场景包括:Tailwind 工具类无法覆盖 MUI 组件样式(通常由选择器优先级或级联层顺序导致)、需要在 Next.js 或 Vite 项目中配置 Tailwind v4、需要在 MUI 组件上使用 className 或 slotProps..className、需要把 --mui- 变量映射进 Tailwind 的 @theme,以及处理遗留的 Tailwind v3 配置或迁移。

主要能力

技能文档按主题组织,覆盖以下内容:

  • Tailwind v4:@layer 顺序设置,确保 mui 层位于 utilities 之前,使 Tailwind 工具类能够正确覆盖 MUI 样式。
  • Next.js:enableCssLayer 的用法;Pages Router 下 GlobalStyles 与共享缓存的配置方式。
  • SPA:StyledEngineProvider 配合 enableCssLayer 的配置方式。
  • 用法:根元素 className 与 slot className 的区别与选择。
  • @theme:将 --mui-* 变量映射到 Tailwind @theme 的完整代码片段(文档站点提供),需要启用 cssVariables。
  • IntelliSense:VS Code 的 classRegex 配置,用于在 MUI 组件属性中识别 Tailwind 类名。
  • Tailwind v3:preflight、important、injectFirst、portals 等兼容性处理。

使用方式

SKILL.md 是入口文件,AGENTS.md 是完整指南,reference.md 提供可直接复制粘贴的代码片段。使用时应先阅读 AGENTS.md,再按需从 reference.md 取用片段。

适用场景

适用于在已有 MUI 项目中引入 Tailwind CSS,或在 Tailwind 项目中引入 MUI,并希望两者样式协同工作的前端开发场景,尤其是 Next.js、Vite 等常见框架下的配置与迁移工作。

限制

资料未提供该技能的具体安装命令、支持的版本范围、收费方式或效果保证等信息,这些内容暂未提供。