Blame view

doc/code-norm/README.md 1.26 KB
weiqingting authored
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53
# 代码规范说明文档

开发前请务必仔细阅读,遵守规范,保持团队代码风格统一

## 文件命名 
* 中划线分隔小写单词
* Ex: `your-file`

## 缩进
* 统一4个Space
* 建议将编辑器Tab映射成4个Space

## 注释
* 为每个你创建的JS文件添加注释

```
/**
 * 对文件实现功能的描述
 * @date: 2016-11-11
 * @author: name<emial@yoho.cn>
 */
```

* 为重要的函数添加注释 

```
/**  
 * 对函数功能的说明
 * @params name paramType 参数描述  
 * @return name returnType 返回值描述  
 */
```

* 为重要的代码、逻辑复杂的代码或者有特殊处理的代码添加注释

```
// Your comments for the code
```
* 减少不必要的注释  
    类似于:**进入循环****循环结束**等垃圾话的注释请谨慎添加,大家都是程序员,不用你注释也能知道的


## html
* 见名知意,不要有1,2,3这种名字出现
* class、id等属性命名为中划线分隔小写单词
* html中请不要出现不必要的嵌套以及不要将标签滥用,比如使用`a`标签作为不跳转的按钮的标签
* 属性按顺序出现:`id -> class -> name -> data-* -> src,for,type,href -> title,alt -> aria-*,role`

## js
[Link](doc/code-norm/js.md)

## css
[Link](doc/code-norm/css.md)