最全的Javascript编码规范(推荐)


Posted in Javascript onJune 22, 2016

1.嵌入规则

Javascript程序应该尽量放在.js的文件中,需要调用的时候在页面中以<script src="filename.js">的形式包含进来。Javascript代码若不是该页面专用的,则应尽量避免在页面中直接编写Javascript代码。

2.对齐缩进与换行

a) 缩进

在同一系统中应采用同一种缩进标准,本文提倡缩进大小为4个空格。各编译器对Tab键所代替的空白大小定义不同。建议在设置开发环境时,将编辑器里的Tab快捷键重新设置成4个空格。多数编译器提供了此功能。否则建议按4次空格来进行缩进。

b) 换行

在以下位置必须换行:

每个独立语句结束后;

if、else、catch、finally、while等关键字前;

运算符处换行时,运算符必须在新行的行首。

对于因为单行长度超过限制时产生的换行,参考行长度中的策略进行分隔。

1).字符串过长截断

每行代码应小于80个字符。若代码较长应尽量换行,换行应选择在操作符和标点符号之后,最好是在分号“;”或逗号“,”之后。下一行代码相对上一行缩进4个空格。这样可以有效防止复制粘贴引起的代码缺失等错误并增强可读性。

按一定长度截断字符串,并使用+运算符进行连接。分隔字符串尽量按语义进行,如不要在一个完整的名词中间断开。特别的,对于HTML片段的拼接,通过缩进,保持和HTML相同的结构:

最全的Javascript编码规范(推荐)

也可使用数组来进行拼接,相对+运算更容易调整缩进:

最全的Javascript编码规范(推荐)

2).三元运算符过长

三元运算符由3部分组成,因此其换行应当根据每个部分的长度不同,形成3种不同的情况:

最全的Javascript编码规范(推荐)

不得出现以下情况:

最全的Javascript编码规范(推荐)

3).过长的逻辑条件组合

当因为较复杂的逻辑条件组合导致80个字符无法满足需求时,应当将每个条件独立一行,逻辑运算符放置在行首进行分隔,或将部分逻辑按逻辑组合进行分隔。最终将右括号)与左大括号{放在独立一行,保证与if内语句块能容易视觉辨识。如:

最全的Javascript编码规范(推荐)

4).过长的JSON和数组

如果对象属性较多导致每个属性一行占用空间过大,可以按语义或逻辑进行分组的组织,如:

最全的Javascript编码规范(推荐)

通过5个一组的分组,将每一行控制在合理的范围内,并且按逻辑进行了切分。 对于项目较多的数组,也可以采用相同的方法,如:

最全的Javascript编码规范(推荐)

最全的Javascript编码规范(推荐)

5).return语句

return如果用表达式的执行作为返回值,请把表达式和 return 放在同一行中,以免换行符被误解析为语句的结束而引起返回错误。return 关键字后若没有返回表达式,则返回 undefined。构造器的默认返回值为 this。

示例:

3.命名

命名的方法通常有以下几类:

a).命名法说明

1).camel命名法,形如thisIsAnApple

2).pascal命名法,形如ThisIsAnApple

3).下划线命名法,形如this_is_an_apple ·

4).中划线命名法,形如this-is-an-apple

根据不同类型的内容,必须严格采用如下的命名法:

b).变量名:必须使用camel命名法

c).参数名:必须使用camel命名法

d).函数名:必须使用camel命名法

e).方法/属性:必须使用camel命名法

f).私有(保护)成员:必须以下划线_开头

g).常量名:必须使用全部大写的下划线命名法,如IS_DEBUG_ENABLED

h).类名:必须使用pascal命名法

i).枚举名:必须使用pascal命名法

j).枚举的属性:必须使用全部大写的下划线命名法

k).命名空间:必须使用camel命名法

l).语义:命名同时还需要关注语义,如:

变量名应当使用名词;

boolean类型的应当使用is、has等起头,表示其类型;·

函数名应当用动宾短语;

类名应当用名词。

4.注释

注释要尽量简单,清晰明了。着重注释的意思,对不太直观的部分进行注解:

最全的Javascript编码规范(推荐)

(当然这种直接定义一堆全局变量的做法不推荐)

此外,JavaScript 的注释有两种"//" 和"/* .... */",建议"//"用作代码行注释,"/* .... */"形式用作对整个代码段的注销,或较正式的声明中,如函数参数、功能、文件功能等的描述中:

最全的Javascript编码规范(推荐)

另:复制粘贴应注意注释是否与代码对应。

5.声明

1).变量的声明

尽管 JavaScript 语言并不要求在变量使用前先对变量进行声明。但我们还是应该养成这个好习惯。这样可以比较容易的检测出那些未经声明的变量,避免其变为隐藏的全局变量,造成隐患。

在函数的开始应先用 var 关键字声明函数中要使用的局部变量,注释变量的功能及代表的含义,且应以字母顺序排序。每个变量单独占一行,以便添加注释。这是因为 JavaScript 中只有函数的 {} 表明作用域,用 var 关键字声明的局部变量只在函数内有效,而未经 var 声明的变量则被视为全局变量。示例:

最全的Javascript编码规范(推荐)

用 var 声明过的变量 valueA 和没有声明的变量 valueB 是有区别的。特别需要注意的是,在函数内部用 var 声明的变量为局部变量,这样可以有效地避免因局部变量和全局变量同名而产生的错误。

2).函数的声明

函数也应在调用前进行声明,内部函数应在 var 声明内部变量的语句之后声明,可以清晰地表明内部变量和内部函数的作用域。

此外,函数名紧接左括号'('之间,而右括号')'和后面的'{'之间要有个空格,以清楚地显示函数名以其参数部分,和函数体的开始。若函数为匿名 / 无名函数,则 function 关键字和左括号'('之间要留空格,否则可能误认为该函数的函数名为 function。

内部函数声明示例:

最全的Javascript编码规范(推荐)

从上例的输出可以看出,inF() 函数仅在 outF() 函数的内部生效,局部变量 innerA 对内部函数的作用域生效。这样的编码方式使得变量和函数的作用域变得清晰。

Javascript 相关文章推荐
JavaScript 判断浏览器类型及版本
Feb 21 Javascript
Riot.js 快速的JavaScript单元测试框架
Nov 09 Javascript
深入理解JavaScript系列(11) 执行上下文(Execution Contexts)
Jan 15 Javascript
得到jQuery detach()后节点中的某个值实现代码
Feb 05 Javascript
JS+CSS实现可拖动的弹出提示框
Feb 16 Javascript
详解JavaScript中循环控制语句的用法
Jun 03 Javascript
bootstrap实现动态进度条效果
Mar 08 Javascript
webstorm添加*.vue文件支持
May 08 Javascript
Vue监听一个数组id是否与另一个数组id相同的方法
Sep 26 Javascript
vue本地打开build后生成的dist文件夹index.html问题
Sep 04 Javascript
Vue.js数字输入框组件使用方法详解
Oct 19 Javascript
js实现选项卡效果
Mar 07 Javascript
Javascript将数值转换为金额格式(分隔千分位和自动增加小数点)
Jun 22 #Javascript
Javascript将数字转化成为货币格式字符串
Jun 22 #Javascript
jQuery soColorPacker 网页拾色器
Jun 22 #Javascript
DIV+CSS+jQ实现省市联动可扩展
Jun 22 #Javascript
Javascript对象字面量的理解
Jun 22 #Javascript
Javascript闭包与函数柯里化浅析
Jun 22 #Javascript
JS中innerHTML和pasteHTML的区别实例分析
Jun 22 #Javascript
You might like
PHP SPL使用方法和他的威力
2013/11/12 PHP
php解析json数据实例
2014/08/19 PHP
php和js实现根据子网掩码和ip计算子网功能示例
2019/11/09 PHP
Jquery+WebService 校验账号是否已被注册的代码
2010/07/12 Javascript
动态加载dtree.js树treeview(示例代码)
2013/12/17 Javascript
jquery通过visible来判断标签是否显示或隐藏
2014/05/08 Javascript
JQuery1.8 判断元素是否绑定事件的方法
2014/07/10 Javascript
详解Javascript 装载和执行
2014/11/17 Javascript
推荐一个自己用的封装好的javascript插件
2015/01/29 Javascript
JSON格式的键盘编码对照表
2015/01/29 Javascript
javascript操作Cookie(设置、读取、删除)方法详解
2015/03/18 Javascript
javascript实现别踩白块儿小游戏程序
2015/11/22 Javascript
js实现常见的工具条效果
2017/03/02 Javascript
详解Angular5路由传值方式及其相关问题
2018/04/28 Javascript
[04:50]DOTA2亚洲邀请赛小组赛第四日 TOP10精彩集锦
2015/02/02 DOTA
[52:02]DOTA2-DPC中国联赛 正赛 Phoenix vs Dragon BO3 第二场 2月26日
2021/03/11 DOTA
python中的多重继承实例讲解
2014/09/28 Python
小小聊天室Python代码实现
2016/08/17 Python
pyQt5实时刷新界面的示例
2019/06/25 Python
Python 脚本拉取 Docker 镜像问题
2019/11/10 Python
python 利用turtle库绘制笑脸和哭脸的例子
2019/11/23 Python
python实现在多维数组中挑选符合条件的全部元素
2019/11/26 Python
Python+unittest+DDT实现数据驱动测试
2020/11/30 Python
老生常谈CSS中的长度单位
2016/06/27 HTML / CSS
JSF界面控制层技术
2013/06/17 面试题
高中化学教学反思
2014/01/13 职场文书
施工质量承诺书范文
2014/05/30 职场文书
2014年党员整改措施范文
2014/09/21 职场文书
2014年残疾人工作总结
2014/12/06 职场文书
工人先锋号申报材料
2014/12/29 职场文书
看古人们是如何赞美老师的?
2019/07/08 职场文书
开学第一周日记(三篇范文)
2019/08/23 职场文书
浅谈redis整数集为什么不能降级
2021/07/25 Redis
2021年国产动漫公司排行前十名,玄机科技上榜,第二推出过铠甲勇士
2022/03/18 杂记
Python OpenCV实现图形检测示例详解
2022/04/08 Python
python APScheduler执行定时任务介绍
2022/04/19 Python