开发规范

中心前端开发规范：https://doc.gz.cvte.cn/code/javascript.html

## 代码规范

### 一、命名规范

1. 文件名、目录名：使用小驼峰，不使用短线和空格；组件名使用大驼峰；
   
2. 常量：大写+短线，必须使用 const 声明；
3. 变量：小驼峰，尽量使用英文将变量的作用描述清楚；避免错别字；

### 二、编码规范

1. 注释：文件注释在顶部使用双斜线描述当前文件；变量名、方法名、类名使用 /** */ 进行注释，以自动生成 JSDoc ；
2. 多个方法之间需要有空行；
3. 空行不允许有空格；
4. 文件末尾需要有单独一行空行；

### 三、业务代码规范

1. 如果是纯函数、工具类函数，优先考虑放入 utils.js 、 tools.js 函数库文件中，方便复用。不要作为组件的内部函数。（例如 formatDate, formatFileSize 等）；
2. 被两个以上模块引入的模块/组件，需要提升到 src/component/ 目录下；

## UI 规范

### 1. 常用列宽配置

### 2. 弹窗

1. 内容高度无需 scroll 的，使用弹窗，否则使用抽屉；
2. 优先使用 MoveableModal 的可移动弹窗；
3. 一次完整功能使用的弹窗深度不得超过三次，否则使用「抽屉+弹窗」或优化需求方案；
4. 最小宽度不得超过1000px；
5. 弹窗内使用 Table 必须加高度；
6. 使用 afterClose 来 onClose 保证弹窗关闭的动画效果；

### 3. 抽屉

1. 内容高度需要 scroll 的，使用抽屉；
2. 设计对象创建、编辑的交互，必须使用抽屉或页面；