MUI v7 组件与实践模式
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/softaworks-agent-toolkit-mui。
技能介绍
你在迁到 MUI v7 时会卡在哪
从 v6 升到 v7 不是换版本号这么简单:深路径导入失效、Modal 的 onBackdropClick 被拿掉、组件统一成 slots / slotProps,还有可选的 CSS layers(和 Tailwind v4 一起用)。日常写界面时,真正花时间的是:用 sx 把样式写对、Grid / Typography / Dialog 等组件按 v7 约定组织,以及主题 token 和断点怎么一致地贯穿页面。
这套技能帮你做什么
技能按工程习惯拆开几块能力:
- 组件与布局:
Box、Grid、Paper、排版、按钮,以及 Card、Dialog/Modal、Loading 等常见模式 - 样式:
sx内联与复杂组件拆到独立样式文件的写法;强调用 主题值 和统一间距,并建议为sx补类型 - 主题与响应式:在
sx里消费 theme、breakpoints、响应式 Typography - 表单与 MUI 钩子:表单相关片段,以及如
useMuiSnackbar等 MUI 侧工具 - 图标与最佳实践:图标用法与和主题、间距一致的建议
更细的条目指向 styling-guide.md、component-library.md、theme-customization.md,适合在助手对话里按场景查模式而不是背整本文档。
适用边界
这是 MUI v7 + React 组件库 导向的模式集,不是通用 CSS 或别的 UI 框架。若项目仍大量依赖 v6 深导入或未迁移 Modal API,需要先把破坏性变更对照官方说明落地。Tailwind v4 + enableCssLayer 只在资料提到的集成场景下才值得启用。
使用场景
- 从 MUI v6 升级后,要把 Modal 和组件的 slots/slotProps 按 v7 写法改完并过一遍回归
- 新产品页用 Grid、Card 和 Typography 搭布局,同时用 `sx` 引用主题间距与配色 token
- 多断点落地时,需要把标题字号和栅格列数按 breakpoints 写成一致的响应式规则
- 复杂表单与提交反馈要结合 MUI 表单片段和 `useMuiSnackbar` 统一成功/失败提示
适合人员
- 维护设计系统、要把 v7 主题 token 和 `sx` 规范写进团队示例库的 React 前端
- 负责 MUI 大版本升级、需要对照 v7 破坏性变更改导入与 Modal 行为的仓库维护者
- 用 MUI 做中后台、每周新增列表/表单/弹窗却不想重复造 Card 与 Loading 模式的业务前端
- 同时接 MUI 与 Tailwind v4、需要评估 `enableCssLayer` 是否合适的全栈工程师