开发规范
文件/资源引入
省略外链资源(图片及其它媒体资源)URL 中的 http / https 协议,使 URL 成为相对地址,避免协议错误的问题
## 推荐
<link type="text/css" rel="styleSheet" href="//at.alicdn.com/t/font_1575378_4afp0w4xjag.css" />
## 不推荐
<link type="text/css" rel="styleSheet" href="http://at.alicdn.com/t/font_1575378_4afp0w4xjag.css" />
命名
变量, 使用驼峰命名。
let loadingModules = {};
私有属性、变量和方法以下划线 _ 开头。
let _privateMethod = {};
常量, 使用全部字母大写。
let MAXCOUNT = 10;
枚举变量 使用 Pascal
命名法。 枚举的属性, 使用全部字母大写,单词间下划线分隔的命名方式。
let TargetState = {
READING: 1,
READED: 2,
APPLIED: 3,
READY: 4
};
boolean 类型的变量使用 is 或 has 开头。
let isReady = false;
let hasMoreCommands = false;
函数
一个函数的长度控制在 50 行以内。 将过多的逻辑单元混在一个大函数中,易导致难以维护。一个清晰易懂的函数应该完成单一的逻辑单元。复杂的操作应进一步抽取,通过函数的调用来体现流程。 特定算法等不可分割的逻辑允许例外。
其它约束
1.0>. 页面根DIV的class统一命名为:container;
2.0>. 最好不要在页面中自定义第三方组件的CSS样式,如:按钮、表格、字体大小等样式,最好全局统一处理;
3.0>. 如果有一段代码或功能,在超过3个地方被重复使用,就必须封装成独立的组件使用。