2021-05-20

前端开发规范

[TOC]

<div STYLE="page-break-after: always;"></div>

一、概述

本规范旨在为前端程序的开发者提供规范化最新的指导，可用于程序员个人编译环境以及研发团队集成环境等场合的代码规范化检查。

不管有多少人共同参与同一项目，一定要确保每一行代码都像是同一个人编写的

二、方针

约束等级	约束效力	强制性
<font color=#f5222d>【强制】</font>	违反该项将被认为代码存在严重缺陷	前端程序团队必须遵守
<font color=#52c41a>【推荐】</font>	违反该项将被认为代码存在轻微缺陷	根据具体产品特性的不同，选择性地遵守
<font color=#1890ff>【参考】</font>	违反该项可被认为代码存在优化空间	从产品持续优化及人员技能提升的角度，参考使用

三、环境要求

【强制】Node.js 8.9 或更高版本，你可以使用 nvm 或 nvm-windows 在一台电脑中管理多个 Node 版本
【强制】使用 Visual Studio Code (VS Code) 进行代码编写
【强制】代码提交前使用 VS Code 进行格式化（不要格式引入的外部文件）
【强制】规定 Tab 大小为 2 个空格，保证在所有环境下获得一致展现
```
// settings.json
{
 "editor.tabSize": 2
 // ...
}
```
【强制】安装插件 Vetur（ Vue开发扩展及 Vue 文件代码格式化）
【强制】安装插件 Prettier - Code formatter（ CSS / Less / JS 等其他文件代码格式化；Vetur 的格式化基于此插件实现，固可以在所有文件实现统一的格式化）

【推荐】使用 Chrome 浏览器并安装 Vue.js devtools 进行调试

四、编码规范

4.1 HTML / Template 编码规范

语法

【强制】缩进使用两个空格代替 Tab
- 前端代码层级较深，使用短缩进有利于利用屏幕空间，提升效率
- 使用两个空格代替 Tab 可以保证在所有环境下获得一致展现
```

<div>
 <div>bar</div>
</div>


<div>
 <div>bar</div>
</div>
```

【强制】嵌套元素应当缩进一次（即两个空格），同层级缩进应保持一致

<!-- not good -->
<div>
<div>bar</div>
  <div>bar</div>
</div>

<!-- good -->
<div>
  <div>bar</div>
  <div>bar</div>
</div>

【强制】对于属性的定义，使用双引号，不要使用单引号
```

<input class='a' type=text>


<input class="a" type="text">
```
【强制】不要省略可选的结束标签（closing tag）（如</li> 或 </body>）

省略可选的结束标签，虽不会违反 H5 规范；但可能会造成层级上的困扰，导致代码出现无法预料的问题
```

<h1>h1 text
 <h2>h2 text


<h1>h1 text</h1>
<h2>h2 text</h2>
```
【强制】特殊符号使用 HTML 字符实体（实体名称对大小写敏感），常用如下：

符号实体编码

空格  

© ©

¥ ¥

® ®

> >

< <

& &

符号	实体编码
空格
©	©
¥	¥
®	®
>	>
<	<
&	&

【强制】td / th 要在 tr 里面，li 要在 ul / ol 里面

<!-- not good -->
<table>
  <td>test</td>
</table>

<!-- good -->
<table>
  <tr>
    <td>test</td>
  </tr>
</table>

【强制】ul / ol 的直接子元素只能是 li，不能包含其他元素
```

<ul>
 123
 <li>a</li>
 <li>b</li>
</ul>
```
【强制】行内元素里面不可使用块级元素

a 标签是一个行内元素，行内元素里面套了一个 div 的标签，这样可能会导致 a 标签无法正常点击
```

<a href="../test">
 <div></div>
</a>
```
可以使用如下代码进行修复：
```
<a href="../test" style="display: block">
 <div></div>
</a>
```
【强制】不使用自定义标签，会与Vue组件系统的自定义组件冲突

【强制】不使用重复属性，重复的属性只会取第一个

<!-- error -->
<input class="a" type="text" class="b">
   
<!-- good -->
<input class="a b" type="text">

【强制】不要在https的链接里写http的图片

只要https的网页请求了一张http的图片，就会导致浏览器地址栏左边的小锁没有了，一般不要写死，写成根据当前域名的协议去加载，用//开头：
```
<img src="//static.chimeroi.com/hello-world.jpg">
```
【推荐】不要在自闭合（self-closing）元素的尾部添加斜线（ HTML5 规范中说明这是可选的）
```

<img src="logo.png" alt />
 

<img src="logo.png" alt>
```

【推荐】不使用属性设置样式（img, table等元素）

<!-- not good -->
<img src="test.jpg" alt width="400" height="300">

<!-- good -->
<img src="test.jpg" style="width:400px;height:300px;">

【参考】自定义属性要以data-开头
自己添加的非标准的属性要以data-开头，否则w3c validator会认为是不规范的
```

<div count="5"></div>


<div data-count="5"></div>
```

HTML5 doctype

【强制】为每个 HTML 页面添加标准模式（standard mode）的声明，确保在每个浏览器中拥有一致的展现

<!DOCTYPE html>

<html>
  ...

语言属性

【强制】为每个 HTML 页面根元素添加 lang 属性

根据 HTML5 规范：

强烈建议为 html 根元素指定 lang 属性，从而为文档设置正确的语言。这将有助于语音合成工具确定其所应该采用的发音，有助于翻译工具确定其翻译时所应遵守的规则等等。

<html lang="zh-CN">
  <!-- ... -->
</html>

字符编码

【强制】通过声明一个明确的字符编码，让浏览器轻松、快速的确定网页内容渲染方式，通常指定为'UTF-8'

<html>
  <head>
    <meta charset="UTF-8">
  </head>
  ...

引入 CSS 和 JavaScript 文件

【强制】根据 HTML5 规范，在引入 CSS 和 JavaScript 文件时不需要指定 type 属性，因为 text/css 和 text/javascript 分别是它们的默认值

<!-- External CSS -->
<link rel="stylesheet" href="code_guide.css">

<!-- In-document CSS -->
<style>
  ...
</style>

<!-- External JS -->
<script src="code_guide.js"></script>

<!-- In-document JS -->
<script>
  ...
</script>

减少标签的数量

【推荐】编写 HTML 代码时，尽量避免多余的层级

<!-- not good -->
<span class="avatar">
  <img src="...">
</span>

<!-- good -->
<img class="avatar" src="...">

属性顺序

【参考】属性应该按照特定的顺序出现以保证易读性

class
id
name
data-*
src, for, type, href, value , max-length, max, min, pattern
placeholder, title, alt
aria-*, role
required, readonly, disabled

语义化

【参考】尽量遵循 HTML 标准和语义，但是不要以牺牲实用性为代价；任何时候都要尽量使用最少的标签并保持最小的复杂度。

4.2 CSS / Less 编码规范

命名

【强制】类名使用小写字母，以中划线分隔
【强制】id 采用驼峰式命名
【强制】less 中的变量、函数、混合等采用驼峰式命名
```
@mainFontColor: #444;

#companyName,
.company-name {
 color: @mainFontColor;
}
```

语法

【强制】所有声明语句都应当以分号结尾
最后一条声明语句后面的分号是可选的，但是，如果省略这个分号，你的代码可能更易出错
```
/* error */
.selector {
 font-size: 15px
 color: red
}

/* not good */
.selector {
 font-size: 15px;
 color: red
}

/* good */
.selector {
 font-size: 15px;
 color: red;
}
```
【强制】避免为 0 值指定单位，例如，用 margin: 0; 代替 margin: 0px;
【强制】为选择器中的属性添加双引号，例如，input[type="text"]；
某些情况下是可选的，但是，为了代码的一致性，建议都加上双引号
```
/* not good */
.selector[type=text] {
 /* ... */
}

/* good */
.selector[type="text"] {
 /* ... */
}
```
【强制】十六进制值应该全部小写，例如，#f3f6fa
【强制】不出现空的规则（声明块中没有声明语句）
【强制】不要设置太大的z-index（一个正常的系统的层级关系在 10 以内就能完成）

【强制】多写注释，且多使用句子进行描述而不是词语

/* 为了去除输入框和表单点击时的灰色背景 */
input, 
form {
    -webkit-tap-highlight-color:  rgba(255, 255, 255, 0);
}

【推荐】不要使用*选择器
【推荐】适当使用:before和:after来画页面的一些视觉上的辅助性元素，如三角形、短的分隔线、短竖线等，可以减少页面上没有用的标签
【推荐】选择器不要超过4层（在 Less 中避免嵌套超过 4 层）
【推荐】用 border: 0; 代替 border: none;
【推荐】使用简写形式的十六进制值，例如，用 #fff 代替 #ffffff
【推荐】对于属性值或颜色参数，省略小于 1 的小数前面的 0 （例如，.5 代替 0.5；-.5px 代替 -0.5px）

代码风格

此处大部分工作将由代码格式化工具完成（参见环境要求），一般无需考虑

【强制】缩进使用两个空格代替 Tab

【强制】为选择器分组时，将单独的选择器单独放在一行

/* not good */
.selector, .selector-secondary, .selector[type=text] {
  /* ... */
}

/* good */
.selector,
.selector-secondary,
.selector[type="text"] {
  /* ... */ 
}

【强制】声明块的左花括号前添加一个空格
【强制】声明块的右花括号应当单独成行
【强制】每条声明语句的 : 后应该插入一个空格

【强制】每条样式声明应该独占一行

/* not good */
.selector {
 font-size: 15px; color: red;
}

/* good */
.selector {
 font-size: 15px;
  color: red;
}

【强制】对于以逗号分隔的属性值，每个逗号后面都应该插入一个空格（例如，box-shadow，transition）
```
/* not good */
.selector {
 transition: border .2s,color .3s,padding .4s;
}

/* good */
.selector {
 transition: border .2s, color .3s, padding .4s;
}
```
【强制】!important前插入一个空格
【强制】注释：//后插入一个空格，/*后插入一个空格，*/前插入一个空格
【强制】Less 的操作符，在圆括号中的数学计算表达式的数值、变量和操作符之间均添加一个空格
【推荐】注释统一用/* */（ Less 中也不要用//）

样式兼容性

【强制】当使用一些较新的 CSS3 语法时，应注意添加浏览器前缀（ FAIS 2 打包工具包含 CSS 预处理，固无需考虑此条）
【推荐】不要使用 input 的 line-height 来做垂直居中
设置 line-height 为一个很高的值会导致 Safari 浏览器的输入光标变得巨大 (与 line-height 等高)
```
/* not good */
input {
 height: 40px;
 line-height: 40px;
}

/* good */
input {
 height: 20px;
 line-height: 20px;
 padding: 10px 0;
}
```

选择器权重（样式覆盖）

权重的基本规则：

相同的权重：以后面出现的选择器为最后规则

不同的权重，权重值高则生效

详细了解权重计算方法

【强制】非通用样式使用嵌套方式进行编写，避免影响其他自己不了解样式，造成样式覆盖
【推荐】Vue 中样式谨慎使用 scoped，会影响样式选择器性能，请使用第一点进行特有样式编写
【推荐】样式需要修改时，尽量找到原样式声明进行修改
【强制】无法修改原样式声明时，应通过权重关系，编写权重更高的样式进行覆盖
【强制】不使用!important，除非原样式使用内联样式或!important且无法直接修改

声明简写

【推荐】当你不确定自己写的属性会否影响到其他属性时，应避免使用简写

/* error */
.element {
  margin: 0 0 10px;
  background: red;
  background: url("image.jpg");
  border-radius: 3px 3px 0 0;
}

/* good */
.element {
  margin-bottom: 10px;
  background-color: red;
  background-image: url("image.jpg");
  border-top-left-radius: 3px;
  border-top-right-radius: 3px;
}

【推荐】当你确定自己的声明不会影响到其他属性时，请使用简写提升代码简洁性

/* not good */
.element {
  padding-top: 10px;
  padding-right: 20px;
  padding-bottom: 15px;
  padding-left: 20px;
}

/* good */
.element {
  padding: 10px 20px 15px;
}

CSS动画

【推荐】不要使用all属性做动画

使用transition做动画的时候不要使用all所有属性，在有一些浏览器上面可能会有一些问题，如下：

transition: all 2s linear;

在Safari上面可能会有一些奇怪的抖动，正确的做法是要用哪个属性做动画就写哪个，如果有多个就用隔开，如下代码所示：

transition: transform 2s linear, opacity 2s linear;

【推荐】位移动画使用 transform 替代 position （提升动画性能）
【推荐】使用 CSS 动画替代 JS 动画

声明顺序

【参考】相关的属性声明按以下顺序做分组处理，组之间需要有一个空行

Positioning（影响其他元素和自身位置相关声明）
Box model（自身盒模型相关声明）
Typographic（文本相关声明）
Visual（自身样式）

Misc（其他声明）

.declaration-order {
  /* Positioning */
  position: absolute;
  top: 0;
  right: 0;
  bottom: 0;
  left: 0;
  z-index: 100;

  /* Box-model */
  display: block;
  float: right;
  width: 100px;
  height: 100px;

  /* Typography */
  font: normal 13px "Helvetica Neue", sans-serif;
  line-height: 1.5;
  color: #333;
  text-align: center;

  /* Visual */
  background-color: #f5f5f5;
  border: 1px solid #e5e5e5;
  border-radius: 3px;

  /* Misc */
  opacity: 1;
}

4.3 JavaScript 编码规范

命名

【强制】标准变量采用驼峰式命名（考虑与后台交换数据的情况，对象属性可灵活命名）
【强制】常量全大写，用下划线连接

【强制】变量名不应过短，要能准确完整地描述该变量所表述的事物

不好的变量名	好的变量名
inp	input, priceInput
day1, day2, param1	today, tomorrow
id	userId, orderId
obj	orderData, houseInfos
tId	removeMsgTimerId
handler	submitHandler, searchHandler

【强制】变量名不要使用计算机术语，如 texareaData，应该取和业务相关的名字，如 leaveMsg
【强制】变量名的对仗要明确，如 up/down、begin/end、opened/closed、visible/invisible、scource/target
【强制】变量名使用正确的语法

不要使用中文拼音，如 shijianchuo 应改成 timestamp ；
如果是复数的话加 s，或者加上 List，如 orderList、menuItems；
而过去式的加上 ed，如 updated/found 等；
如果正在进行的加上 ing，如 calling；
【推荐】使用临时变量时请结合实际需要进行变量命名

有些喜欢取temp和obj之类的变量，如果这种临时变量在两行代码内就用完了，接下来的代码就不会再用了，还是可以接受的，如交换数组的两个元素。但是有些人取了个temp，接下来十几行代码都用到了这个temp，这个就让人很困惑了。所以应该尽量少用temp类的变量
```
// not good
let temp = 10;
let leftPosition = currentPosition + temp，
 topPosition = currentPosition - temp;

// good
let adjustSpace = 10;
let leftPosition = currentPosition + adjustSpace，
 topPosition = currentPosition - adjustSpace;
```
【推荐】波尔变量可以结合实际语境使用 done/found/successs/ok/available/complete 等修饰词
```
// good
let ajaxDone = true,
 fileFound = false,
 resourceUpdated = true;
```
【推荐】波尔变量名应使用肯定的布尔变量名，不要使用否定的名词，如 notOk、notReady，因为否定的词取反的时候就会比较奇怪，如 if (!notOk)

语法

【强制】变量不要先使用后声明
【强制】不要声明了变量却不使用
【强制】不要在同个作用域下声明同名变量
【强制】一个函数作用域中所有的变量声明尽量提到函数首部，可根据代码进行分组，但不允许出现两个连续的变量声明
```
// not good
let registerForm = null;
let question = "";
let calculateResult = 0;

// good
let registerForm = null,
 question = "",
 calculateResult = 0;
```

【强制】为了快速知晓变量类型，声明变量时要赋值

// not good
let registerForm,
    question,
    calculateResult;

// good
let registerForm = null,
    question = "",
    calculateResult = 0;

【强制】单一函数的返回值类型要确定（如下无法确定该函数的最终返回类型）

// not good
function calculatePrice(seatCount){
  if (seatCount <= 0) {
     return "";
  } else {
     return seatCount * 79;
  }
}

【强制】debugger不要出现在提交的代码里

【推荐】使用===代替==，!==代替!=（==会自动进行类型转换，可能会出现奇怪的结果）

null == undefined          //true
'' == '0'                  //false
0  == ''                   //true
0  == '0'                  //true
' \t\r\n ' == 0            //true
new String("abc") == "abc" //true
new Boolean(true) == true  //true
true == 1                  //true

【推荐】使用三目运算代替简单的 if-else

// not good
let seatDiscount = 100;
if (seat < 5) {
  seatDiscount = 90;
} else if(seat < 10) {
  seatDiscount = 80;
} else {
  seatDiscount = 70;
}

// good
let seatDiscount = seat < 5 ? 90 : seat < 10 ? 80 : 70;

【推荐】使用let定义变量，const定义常量

【推荐】使用箭头函数取代简单的函数

// not good
let _this = this;
setTimeout(function() {
  _this.foo = "bar";
}, 2000);

// good
setTimeout(() => this.foo = "bar", 2000);

【推荐】在必要的地方添加非空判断以提高代码的稳健性
【推荐】将复杂的函数分解成多个子函数，方便维护和复用

代码风格

此处大部分工作将由代码格式化工具完成（参见环境要求），一般无需考虑

【强制】缩进使用两个空格代替 Tab
【强制】统一使用双引号""（与 Prettier 默认格式化配置持一致）
【强制】以下几种情况后需加分号;
- 变量声明
- 表达式
- return
- throw
- break
- continue
- do-while
【强制】以下几种情况不需要空格：
- 对象的属性名后
- 前缀一元运算符后
- 后缀一元运算符前
- 函数调用括号前
- 无论是函数声明还是函数表达式，'('前不要空格
- 数组的'['后和']'前
- 对象的'{'后和'}'前
- 运算符'('后和')'前
【强制】以下几种情况需要空格：
- 二元运算符前后
- 三元运算符'?:'前后
- 代码块'{'前
- 下列关键字前：else, while, catch, finally
- 下列关键字后：if, else, for, while, do, switch, case, try,catch, finally, with, return, typeof
- 单行注释'//'后（若单行注释和代码同行，则'//'前也需要），多行注释'*'后
- 对象的属性值前
- for循环，分号后留有一个空格，前置条件如果有多个，逗号后留一个空格
- 无论是函数声明还是函数表达式，'{'前一定要有空格
- 函数的参数之间

数组、对象

【强制】对象属性名不需要加引号
【强制】对象以缩进的形式书写，不要写在一行
【强制】数组中不要存在空元素
【强制】不要用for in循环数组

【推荐】数组、对象最后不要有逗号

// not good
let a = {
  'b': 1
};

let a = { b: 1 };

let a = {
  b: 1,
  c: 2,
};

// good
let a = {
  b: 1,
  c: 2
};

使用 null

【强制】正确使用 null

适用场景：

初始化一个将来可能被赋值为对象的变量

与已经初始化的变量做比较

作为一个参数为对象的函数的调用传参

作为一个返回对象的函数的返回值

不要用null来判断函数调用时有无传参

不要与未初始化的变量做比较

// not good
function test(a, b) {
  if (b === null) {
    // not mean b is not supply
    // ...
  }
}

let a;

if (a === null) {
  // ...
}

// good
let a = null;

if (a === null) {
  // ...
}

使用 undefined

【强制】正确使用 undefined

不要给变量赋值 undefined（undefined 本身就表示一个变量未定义）
不要直接使用 undefined 进行变量判断

使用typeof和字符串 'undefined' 对变量进行判断

// not good
if (person === undefined) {
  // ...
}

// good
if (typeof person === 'undefined') {
  // ...
}

文档注释

【参考】各类标签 @param, @method 等请参考 usejsdoc 和 JSDoc Guide；

建议在以下情况下使用：

所有常量
所有函数
所有类

/**
 * @func
 * @desc 一个带参数的函数
 * @param {string} a - 参数a
 * @param {number} b=1 - 参数b默认值为1
 * @param {string} c=1 - 参数c有两种支持的取值</br>1—表示x</br>2—表示xx
 * @param {object} d - 参数d为一个对象
 * @param {string} d.e - 参数d的e属性
 * @param {string} d.f - 参数d的f属性
 * @param {object[]} g - 参数g为一个对象数组
 * @param {string} g.h - 参数g数组中一项的h属性
 * @param {string} g.i - 参数g数组中一项的i属性
 * @param {string} [j] - 参数j是一个可选参数
 */
function foo(a, b, c, d, g, j) {
  // ...
}

4.4 Vue 组件编码规范

命名

【强制】组件名应该始终是多个单词的，根组件 App 除外

// not good
Vue.component('todo', {
  // ...
})
export default {
  name: 'Todo',
  // ...
}

// good
Vue.component('todo-item', {
  // ...
})
export default {
  name: 'TodoItem',
  // ...
}

【强制】单文件组件的文件名应该要么始终是单词大写开头（ PascalCase ），要么始终是横线连接（ kebab-case ）
```
// not good
components/
|- mycomponent.vue

components/
|- myComponent.vue

// good
components/
|- MyComponent.vue

components/
|- my-component.vue
```

【推荐】应用特定样式和约定的基础组件 (也就是展示类的、无逻辑的或无状态的组件) 应该全部以一个特定的前缀开头，比如 Base、App 或 V

// not good
components/
|- MyButton.vue
|- VueTable.vue
|- Icon.vue

// good
components/
|- BaseButton.vue
|- BaseTable.vue
|- BaseIcon.vue

components/
|- AppButton.vue
|- AppTable.vue
|- AppIcon.vue

components/
|- VButton.vue
|- VTable.vue
|- VIcon.vue

【推荐】只应该拥有单个活跃实例的单例组件应该以 The 前缀命名，以示其唯一性

单例组件不意味着组件只可用于一个单页面，而是每个页面只使用一次。这些组件永远不接受任何 prop，因为它们是为你的应用定制的，而不是它们在你的应用中的上下文。如果你发现有必要添加 prop，那就表明这实际上是一个可复用的组件，只是目前在每个页面里只使用一次
```
// not good
components/
|- Heading.vue
|- MySidebar.vue

// good
components/
|- TheHeading.vue
|- TheSidebar.vue
```
【强制】和父组件紧密耦合的子组件应该以父组件名作为前缀命名

如果一个组件只在某个父组件的场景下有意义，这层关系应该体现在其名字上。因为编辑器通常会按字母顺序组织文件，所以这样做可以把相关联的文件排在一起
```
// not good
components/
|- TodoList.vue
|- TodoItem.vue
|- TodoButton.vue
components/
|- SearchSidebar.vue
|- NavigationForSearchSidebar.vue

//good
components/
|- TodoList.vue
|- TodoListItem.vue
|- TodoListItemButton.vue
components/
|- SearchSidebar.vue
|- SearchSidebarNavigation.vue
```

【强制】组件名应该以高级别的 (通常是一般化描述的) 单词开头，以描述性的修饰词结尾

// not good
components/
|- ClearSearchButton.vue
|- ExcludeFromSearchInput.vue
|- LaunchOnStartupCheckbox.vue
|- RunSearchButton.vue
|- SearchInput.vue
|- TermsCheckbox.vue

// good
components/
|- SearchButtonClear.vue
|- SearchButtonRun.vue
|- SearchInputQuery.vue
|- SearchInputExcludeGlob.vue
|- SettingsCheckboxTerms.vue
|- SettingsCheckboxLaunchOnStartup.vue

【推荐】组件名应该倾向于完整单词而不是缩写

// not good
components/
|- SdSettings.vue
|- UProfOpts.vue

// good
components/
|- StudentDashboardSettings.vue
|- UserProfileOptions.vue

语法

【强制】组件的 data 必须是一个函数（除了 new Vue 外的任何地方）

// not good
export default {
  data: {
    foo: 'bar'
  }
}

// good
export default {
  data () {
    return {
      foo: 'bar'
    }
  }
}

【强制】prop 的定义应该尽量详细，至少需要指定其类型

// not good
// 这样做只有开发原型系统时可以接受
props: ['status']

// good
props: {
  status: String
}

// better
props: {
  status: {
    type: String,
    required: true,
    validator: function (value) {
      return [
        'syncing',
        'synced',
        'version-conflict',
        'error'
      ].indexOf(value) !== -1
    }
  }
}

【强制】为 v-for 设置键值；在组件上总是必须用 key 配合 v-for，以便维护内部组件及其子树的状态

在组件上总是必须用 key 配合 v-for，以便维护内部组件及其子树的状态

【强制】不要把 v-if和 v-for 同时用在同一个元素上（大部分时候你可以使用计算属性实现）

<!-- not good -->
<ul>
  <li
    v-for="user in users"
    v-if="user.isActive"
    :key="user.id"
  >
    {{ user.name }}
  </li>
</ul>

<!-- good -->
<ul>
  <li
    v-for="user in activeUsers"
    :key="user.id"
  >
    {{ user.name }}
  </li>
</ul>

【强制】自闭合组件在单文件组件、字符串模板和 JSX 中没有内容的组件应该是自闭合的；但在 DOM 模板里不要这样做

<!-- not good -->
<!-- 在单文件组件、字符串模板和 JSX 中 -->
<MyComponent></MyComponent>
<!-- 在 DOM 模板中 -->
<my-component/>

<!-- good -->
<!-- 在单文件组件、字符串模板和 JSX 中 -->
<MyComponent/>
<!-- 在 DOM 模板中 -->
<my-component></my-component>

【强制】模版中的组件名大小写在单文件组件和字符串模板中组件名应该总是 PascalCase 的；但是在 DOM 模板中总是 kebab-case 的

<!-- not good -->
<!-- 在单文件组件和字符串模板中 -->
<mycomponent/>
<!-- 在单文件组件和字符串模板中 -->
<myComponent/>
<!-- 在 DOM 模板中 -->
<MyComponent></MyComponent>

<!-- good -->
<!-- 在单文件组件和字符串模板中 -->
<MyComponent/>
<!-- 在 DOM 模板中 -->
<my-component></my-component>

亦或者

<!-- 在所有地方 -->
<my-component></my-component>

【强制】JS/JSX 中的组件名应该始终是 PascalCase 的

// not good
Vue.component('myComponent', {
  // ...
})
import myComponent from './MyComponent.vue'
export default {
  name: 'myComponent',
  // ...
}
export default {
  name: 'my-component',
  // ...
}

// good
Vue.component('MyComponent', {
  // ...
})
import MyComponent from './MyComponent.vue'
export default {
  name: 'MyComponent',
  // ...
}

【推荐】Prop 名大小写，在声明 prop 的时候，其命名应该始终使用 camelCase，而在模板和 JSX 中应该始终使用 kebab-case
```
// not good
props: {
 'greeting-text': String
}
<WelcomeMessage greetingText="hi"/>

// good
props: {
 greetingText: String
}
<WelcomeMessage greeting-text="hi"/>
```

【推荐】多个特性的元素应该分多行撰写，每个特性一行（此项 Vetur 插件会自动根据行宽阈值进行自动折行处理，一般无需考虑）

<!-- not good -->
<img src="https://vuejs.org/images/logo.png" alt="Vue Logo">
<MyComponent foo="a" bar="b" baz="c"/>

<!-- good -->
<img
  src="https://vuejs.org/images/logo.png"
  alt="Vue Logo"
>
<MyComponent
  foo="a"
  bar="b"
  baz="c"
/>

【强制】组件模板应该只包含简单的表达式，复杂的表达式则应该重构为计算属性或方法

// not good
{{
  fullName.split(' ').map(function (word) {
    return word[0].toUpperCase() + word.slice(1)
  }).join(' ')
}}

// good
// 在模板中
{{ normalizedFullName }}
// 复杂表达式已经移入一个计算属性
computed: {
  normalizedFullName: function () {
    return this.fullName.split(' ').map(function (word) {
      return word[0].toUpperCase() + word.slice(1)
    }).join(' ')
  }
}

【推荐】应该把复杂计算属性分割为尽可能多的更简单的属性

// not good
computed: {
  finalPrice: function () {
    var basePrice = this.manufactureCost / (1 - this.profitMargin)
    return (
      basePrice -
      basePrice * (this.discountPercent || 0)
    )
  }
}

// good
computed: {
  basePrice: function () {
    return this.manufactureCost / (1 - this.profitMargin)
  },
  discount: function () {
    return this.basePrice * (this.discountPercent || 0)
  },
  finalPrice: function () {
    return this.basePrice - this.discount
  }
}

【强制】非空 HTML 特性值应该始终带引号

<!-- not good -->
<input type=text>
<AppSidebar :style={width:sidebarWidth+'px'}>

<!-- good -->
<input type="text">
<AppSidebar :style="{ width: sidebarWidth + 'px' }">

【强制】可简写指令需要缩写 (用 : 表示 v-bind: 和用 @ 表示 v-on:)

代码风格

此处大部分工作将由代码格式化工具完成（参见环境要求），一般无需考虑

具体要求见 4.1 ，4.2，4.3 中代码风格部分

组件/实例的选项的顺序

【参考】组件/实例的选项应该有统一的顺序，这是我们推荐的组件选项默认顺序：

副作用 (触发组件外的影响)
- el
全局感知 (要求组件以外的知识)
- name
- parent
组件类型 (更改组件的类型)
- functional
模板修改器 (改变模板的编译方式)
- delimiters
- comments
模板依赖 (模板内使用的资源)
- components
- directives
- filters
组合 (向选项里合并属性)
- extends
- mixins
接口 (组件的接口)
- inheritAttrs
- model
- props/propsData
本地状态 (本地的响应式属性)
- data
- computed
事件 (通过响应式事件触发的回调)
- watch
- 生命周期钩子 (按照它们被调用的顺序)
  - beforeCreate
  - created
  - beforeMount
  - mounted
  - beforeUpdate
  - updated
  - activated
  - deactivated
  - beforeDestroy
  - destroyed
非响应式的属性 (不依赖响应系统的实例属性)
- methods
渲染 (组件输出的声明式描述)
- template/render
- renderError

元素特性的顺序

【参考】元素 (包括组件) 的特性应该有统一的顺序，这是我们为元素特性推荐的默认顺序：

定义 (提供组件的选项)
- is
列表渲染 (创建多个变化的相同元素)
- v-for
条件渲染 (元素是否渲染/显示)
- v-if
- v-else-if
- v-else
- v-show
- v-cloak
渲染方式 (改变元素的渲染方式)
- v-pre
- v-once
全局感知 (需要超越组件的知识)
- id
唯一的特性 (需要唯一值的特性)
- ref
- key
- slot
双向绑定 (把绑定和事件结合起来)
- v-model
其它特性 (所有普通的绑定或未绑定的特性)
事件 (组件事件监听器)
- v-on
内容 (覆写元素的内容)
- v-html
- v-text

单文件组件的顶级元素的顺序

【强制】单文件组件应该总是按照 <template>、<script> 和 <style> 的标签顺序

<!-- good -->
<!-- ComponentA.vue -->
<template>...</template>
<style>/* ... */</style>

<!-- ComponentB.vue -->
<template>...</template>
<script>/* ... */</script>
<style>/* ... */</style>

隐性的父子组件通信

【强制】应该优先通过 prop 和事件进行父子组件之间的通信，而不是 this.$parent 或改变 prop。

一个理想的 Vue 应用是 prop 向下传递，事件向上传递的。遵循这一约定会让你的组件更易于理解。然而，在一些边界情况下 prop 的变更或 this.$parent 能够简化两个深度耦合的组件。

问题在于，这种做法在很多简单的场景下可能会更方便。但请当心，不要为了一时方便 (少写代码) 而牺牲数据流向的简洁性 (易于理解)。

非 Flux 的全局状态管理

【强制】应该优先通过 Vuex 管理全局状态，而不是通过 this.$root 或一个全局事件总线。

通过 this.$root 和/或全局事件总线管理状态在很多简单的情况下都是很方便的，但是并不适用于绝大多数的应用。Vuex 提供的不仅是一个管理状态的中心区域，还是组织、追踪和调试状态变更的好工具。

最后编辑于：2021.05.21 11:14:54

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 203,547评论 6赞 477
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 85,399评论 2赞 381
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 150,428评论 0赞 337
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,599评论 1赞 274
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,612评论 5赞 365
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,577评论 1赞 281
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,941评论 3赞 395
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,603评论 0赞 258
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,852评论 1赞 297
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,605评论 2赞 321
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,693评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,375评论 4赞 318
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,955评论 3赞 307
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,936评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,172评论 1赞 259
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 43,970评论 2赞 349
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,414评论 2赞 342

2021-05-20

前端开发规范

一、概述

二、方针

三、环境要求

四、编码规范

4.1 HTML / Template 编码规范

语法

HTML5 doctype

语言属性

字符编码

引入 CSS 和 JavaScript 文件

减少标签的数量

属性顺序

语义化

4.2 CSS / Less 编码规范

命名

语法

代码风格

样式兼容性

选择器权重（样式覆盖）

声明简写

CSS动画

声明顺序

4.3 JavaScript 编码规范

命名

语法

代码风格

数组、对象

使用 null

使用 undefined

文档注释

4.4 Vue 组件编码规范

命名

语法

代码风格

组件/实例的选项的顺序

元素特性的顺序

单文件组件的顶级元素的顺序

隐性的父子组件通信

非 Flux 的全局状态管理

推荐阅读更多精彩内容