ui2-upgrade-guide
Installation
SKILL.md
ui2 组件通用升级规范
本文档适用于所有从 ui-components 迁移至 ui2-components 的组件,涵盖核心原则、组件结构、Vue 3 语法升级(含 TypeScript)、样式标准化、pageCenter 数据结构对齐等通用规范。
运行环境:项目实际使用 Vue 2.7.16(支持
<script setup>和 Composition API),编写时需注意 Vue 2.7 兼容性限制,详见 1.10 节。团队组件规范:https://wepie.feishu.cn/wiki/G3oewXa3hiRQYfkAUMJcSfr6nAh
一、核心原则
- 单一职责:一个组件只做一件事,可再通过插槽或组合式函数扩展
- 开闭原则:组件需要对扩展开放、对修改关闭
- 单向数据流:父子通信必须遵循单向数据流,避免在子组件中直接修改父组件的值
- 迁移不是翻译:不能单纯转译,该优化的一定要优化