Javascript编码规范学习

标签：style   blog   http   io   ar   color   使用   sp   java   

http://javascript.crockford.com/code.html文章学习笔记。

1、使用js文件管理代码

所有代码尽量放在js文件中，然后再html文件中使用script引入，引入时注意放在body标签后面，并且不使用type或者language。

2、书写缩进

使用4个空白格缩进，注意不要使用tab键进行缩进。

3、断句

注意行长，每行不超过80个字符，超过时要进行适当断句，断句应该再操作符后面进行，最理想的是在逗号（，）后面进行断句，断句后下一行使用8格缩进。

4、注解

一般使用单行注释，块注释一般用于文档。

5、变量声明

1. 所有变量使用之前先声明，未声明的变量会自动作为全局变量。全文应少使用全局变量。
2. 最好把所有变量声明用一个var实现，并且每个声明单独放一行，并添加注释说明，如果可以所有声明变量按照字符顺序列出，如下：

3. var currentEntry,      //当前选择表项目
       level;          //缩进级别
   

4. 在函数体内顶部定义所有变量，则var出现在函数体首行。

6、函数声明

1. 所有函数使用前应该先声明，并且在变量之后进行-------有助于查看作用域。
2. 函数名和括号直接不应该有空格；右括号（和函数参数之间不应该有空格；左括号）和函数体括号{之间有一个空格；函数体缩进4个空格；函数体结束括号}和函数声明关键字function首字符对齐。如下代码：

   1. function outer(c,d) {
          var e = c * d;
      
          function inner(a,b) {
              return (e * a ) + b;
          }
      
          return inner(0,1);
      }

3. 函数和对象可以被放在任何允许放表达式的地方。
4. 匿名函数关键字function和左括号（之间有一个空格。
5. 尽量少使用全局函数。
6. 对于立即执行函数，整个调用表达式应放在一对个括号（）里面，以明确变量的值是函数执行结果而不是函数本身。如下代码：

   var result = (function () {
       var key = "";
       return {
           get: function () {
               return key;
           },
           set: function (key) {
               key = key;
           }
       };
   }());

7、命名

1. 以字母、数字、下划线命名，避免使用国际字符、美元符号$、反斜杠\。
2. 不要使用下划线作为名称的首位字符。
3. 大多数变量和函数使用小写字母开头命名。
4. 构造函数必须使用大写字母开头，在js中省略new不会报错（编译或者运行错误），但最好不要省略。
5. 全局变量应用全部大写命名（js中没有宏和常量的概念）。

8、语句

1. 简单语句
   1. 每行最多一条语句，并且使用分号;结尾，注意以函数字面量和对象字面量赋值的语句也要使用分号;。
   2. js允许任何一个变量作为一条语句，但是在插入分号的时候可能会引起某些错误，因此一般使用表达式的语句是赋值或者函数调用语句（这句英文原文我大概理解了，但是不知道怎么翻译出来比较好）
2. 复合语句（包含在一对{}之间的语句）
   1. 内部语句缩进4个空格。
   2. 左括号{应该在开始语句行的末尾。
   3. 右括号应该在最后单独一行，并且与左括号所在行的首字符对齐。
   4. 当语句在控制语句（例如for、if等）中时，应该使用花括号{}将语句包围起来，即使只有一条语句，这样可以保证在添加语句时不产生bug。

9、标签（这一部分的理解感觉不是很对）

要使用label的语句是有选择性的，只有下面几种：while、for、do、switch。

10、返回语句

返回的值应该用圆括号括起来，且返回表达式应该和return关键字在同一行（避免换行插入分号）。

11、if语句

遵循如下格式：

if (condition) {
    statements
}

if (condition) {
    statements
} else {
    statements
}

if (condition) {
    statements
} else if (condition) {
    statements
} else {
    statements
}

12、for语句

遵循如下格式：

for (initiliazation; condition; update) {
    statements
}

for (variable in object) {
    if (filter) {
        statements
    }
}

1. 第一种循环格式用于数组和可以判断迭代次数的变量。
2. 第二中用于对象遍历
   1. 注：此处提到了在对象原型中添加的属性是可以枚举的，因此要使用hasOwnProperty方法进行筛选，但是我用for in代码测试的时候，没有显示，这里不知道问题出在了哪里。

13、while语句

遵循如下格式：

while (condition) {
    statements
}

14、do-while语句

遵循如下格式：

do {
    statements  
} while (condition);

语句结尾要添加分号。

15、switch语句

遵循如下格式：

switch (expression) {
case expression:
    statements
default:
    statements
}

1. 每一个case都要和switch对齐，避免过分缩进，只有case标签不是语句，应该不应该缩进。
2. 每个case语句（除了default）必须要以break或return或throw结尾。

16、try语句

遵循如下格式：

try {
    statements
} catch (variable) {
    statements
}

try {
    statements
} catch (variable) {
    statements
} finally {
    statements
}

17、continue语句

避免使用continue语句。

18、with语句

不应该使用with语句。

19、空格使用

1. 通过设置空行来分割逻辑相关的代码段，以增强代码可读性。
2. 在以下情况下设置空格：
   1. 关键字之后跟随左括号（要使用空格，例如：

   2. while (true) {

   3. 不能在函数参数和左括号（之间使用空格。
   4. 除了点号（.）、左圆括号（(）、方括号（[）以外的二元运算符都要使用一个空格来和操作数分割开。
   5. 除了typeof以外的一元操作符和他的操作数之间不应有空格。
   6. for语句控制块()中每个分号;之后有一个空格。
   7. 每个逗号后面要有一个空格。

20、额外建议

1. []和{}
1. 当成员名称是连续整数时使用数组，当成员名称是任意字符串和名称时使用对象。
2. 使用{}代替new object()，使用[]代替new Array()。
2. 逗号,操作符
   1. 避免使用逗号,操作符（这一规定不适用于对象字面量、数组字面量定义和var声明语句以及参数列表）
3. 块级作用域
   1. 除了符合语句不使用语句块，js没有块级作用域，只有函数作用域。
4. 赋值表达式
   1. while和if语句中条件判断部分避免使用赋值语句。
5. ===和!==
   1. 判定相等使用全等符号（===和!==），避免使用强制类型相等转换符号（==和!=）。
6. 若一个数字加（或者-）一个带有符号（+或者-）的数字，或者带有（++或--）的数字，则需要将带有符号或者（++或--）的数字括起来。
7. eval是恶魔（eval的滥用l）
1. eval有相同情况，不应使用Function构造函数，不向setTimeout或setInterval函数传递字符串。

Javascript编码规范学习

标签：style   blog   http   io   ar   color   使用   sp   java   

原文地址：http://www.cnblogs.com/rabbitpl/p/4126877.html