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


一、核心原则

  1. 单一职责:一个组件只做一件事,可再通过插槽或组合式函数扩展
  2. 开闭原则:组件需要对扩展开放、对修改关闭
  3. 单向数据流:父子通信必须遵循单向数据流,避免在子组件中直接修改父组件的值
  4. 迁移不是翻译:不能单纯转译,该优化的一定要优化

Installs
29
First Seen
Jul 3, 2026
ui2-upgrade-guide from mercury-api.wepieoa.com