UMP-Javascript编码规范.docxVIP

UMP JavaScript编码及开发规范前言软件的长期价值直接源于其编码质量。在它的整个生命周期里,一个程序可能会被许多人阅读或修改。如果一个程序可以清晰的展现出它的结构和特征,那就能减少在以后对其进行修改时出错的可能性。编程规范可以帮助程序员们增加程序的健壮性。JavaScript文件JavaScript程序应独立保存在后缀名为.js的文件中。JavaScript代码不应该被包含在HTML文件中,除非这是段特定只属于此部分的代码。在HTML中的JavaScript代码会明显增加文件大小,而且也不能对其进行缓存和压缩。filename.js应尽量放到body的后面。这样可以减少因为载入script而造成其他页面内容载入也被延迟的问题。也没有必要使用language或者type属性。MIME类型是由服务器而非scripttag来决定的。缩进缩进的单位为四个空格。避免使用Tab键来缩进（因为没有个统一的Tab长短标准）。虽然使用空格会增加文件的大小,但在最小化过程中也可被消除掉。每行长度避免每行超过80个字符。当一条语句一行写不下时,请考虑折行。在运算符号,最好是逗号后换行。在运算符后换行可以减少因为复制粘贴产生的错误被分号掩盖的几率。下一行应该缩进8个空格。注释不要吝啬注释。给以后需要理解你的代码的人们(或许就是你自己)留下信息是非常有用的。注释应该和它们所注释的代码一样是书写良好且清晰明了。偶尔的小幽默就更不错了。记得要避免冗长或者情绪化。及时地更新注释也很重要。错误的注释会让程序更加难以阅读和理解。让注释有意义。重点在解释那些不容易立即明白的逻辑上。不要把读者的时间浪费在阅读类似于:i = 0; //让i等于0使用单行注释。块注释用于注释正式文档和无用代码。变量声明所有的变量必须在使用前进行声明。JavaScript并不强制必须这么做,但是这么做可以让程序易于阅读,且也容易发现那些没声明的变量(它们会被编译成全局变量)。将var语句放在函数的首部。最好把每个变量的声明语句单独放到一行,并加上注释说明。所有变量按照字母排序。varcurrentEntry; // 当前选择项var level; // 缩进程度var size; // 表格大小JavaScript没有块范围,所以在块里面定义变量很容易引起C/C++/Java程序员们的误解。在函数的首部定义所有的变量。尽量减少全局变量的使用。不要让局部变量覆盖全局变量。函数声明所有的函数在使用前进行声明。内函数的声明跟在var语句的后面。这样可以帮助判断哪些变量是在函数范围内的。函数名与((左括号)之间不应该有空格。)(右括号)与开始程序体的{(左大括号)之间应插入一个空格。函数程序体应缩进四个空格。}(右大括号)与声明函数的那一行代码头部对齐。function outer(c, d) { var e = c * d;function inner(a, b) {return (e * a) + b;} return inner(0, 1);}如果函数是匿名函数,则在function和((左括号)之间应有一个空格。如果省略了空格,否则会让人感觉函数名叫作 function。div.onclick = function (e) {return false; }; 命名规范变量名应由26个大小写字母(A..Z,a..z),10个数字(0..9),和_(下划线)组成。避免使用国际化字符(如中文),因为它们不是在任何地方都可以被方便的阅读和理解。不要在命名中使用$(美元符号)或者(反斜杠)。常量及全局变量采用全部大写的形式。变量名采用大小写混合形式，除首单词的字母全部小写外其余单词的首字母都大写。方法名一样。变量名过长的可以采用单词缩写，除广泛使用的缩写外，采用单词缩写的变量名必须添加注释。不要把_(下划线)作为变量名的第一个字符。它有时用来表示私有变量,但实际上JavaScript并没提供私有变量的功能。如果私有变量很重要, 那么使用私有成员的形式。应避免使用这种容易让人误解的命名习惯。必须与new共同使用的构造函数名应以大写字母开头。当new被省略时JavaScript不会有任何编译错误或运行错误抛出。忘记加new时会让不好的事情发生(比如被当成一般的函数),所以大写构造函数名是我们来尽量避免这种情况发生的唯一办法。8.1函数名称的命名规范函数名尽量采用 “动词+名次”的命名方式。函数名称中的动词前缀必须是和函数功能相关的完整动词。函数名称的第一个单词全部小写，后面的单词首字母大写。函数的大括号对齐方式，例如：???? functiongetUserName(){?????? //此处要开始缩进。??? ?}8.2类的命名