javascript代码规范小结

1. javascript代码应符合douban-jslint检验标准

1-1. 语句必须都有分号结尾，除了for, function, if, switch, try, while

1-2. 只有长语句可以考虑断行，如：

templ_songlist.replace('{table}', da['results'])
.replace('{prev_num}', prev)
.replace('{next_num}', next)
.replace('{current_num}', current)
.replace('{total_num}', da.page_total);

为了避免和jslint的检验机制冲突，“.”或“＋”这类操作符放在行尾，上面代码应改为：

templ_songlist.replace('{table}', da['results']).
replace('{prev_num}', prev).
replace('{next_num}', next).
replace('{current_num}', current).
replace('{total_num}', da.page_total);

1-3. 避免额外的逗号。如：var arr = [1,2,3,];

1-4. 所有的循环体和判断体都需要用"{}"括起来。如：

错：

if (condition)
statement;
或
if (condition) statement;


对:

if (condition) {
statement; 或
if (condition) { statement; }

1-5. for-in循环体中必须用hasownproperty方法检查成员是否为自身成员。避免来自原型链上的污染。

1-6. 变量声明。变量声明应放在function的最上面。避免使用未声明的变量。

错：

if (n > 0) {
var isvalid = true;

对：

var isvalid;
if (n > 0) {
isvalid = true;
}

1-7. 不要使用with, void, evil。

1-8. 使用严格的条件判断符。用===代替==，用!==代替!=。

1-9. 下面类型的对象不建议用new构造：new number, new string, new boolean, new object(用{}代替), new array(用[]代替)。

1-10. 引用对象成员用obj.prop1代替obj[“prop1”]，除非属性名是变量。

注：douban-jslint是定制过的jslint

注：如果模块代码中，使用其它全局变量想跳过jslint的检查，可以在该文件中加入声明，如：

2. javascript命名规则

2-1. 构造器的首字母大写。如：

function dialog (config) {
statement;
} var dlg = new dialog({...});

2-2. 对象的属性或方法名采用小驼峰式(lower camel-case)，如"init", "bindevent", "updateposition"：

dialog.prototype = {
init: function () {},
bindevent: function () {},
updateposition: function () {} };

2-3. 私有变量名用下划线开头。如："_current", "_defaultconfig"

2-4. 常量名全部大写，单词间用下划线分隔。如：“css_btn_close”, "txt_loading"

2-5. 变量名的前缀：

prefix

element

example

integer

nvariablename

i,j,k,m,n, etc. *

integer as counter/iterator

(for i=0; i<=oarray.length; i++)

string

svariablename

object

oobjectname

is, can, has

boolean

[boolean name]conditionname

event method

event attachment

[event type]_methodname

accessor method

getmethodname

accessor method

setmethodname

note: only a counter/iterator should use a single-letter designation.

3. 代码格式化要求

3-1. 语句中的必要空格和缩进

3-1-1. 用来包含语句的"()"前后需要跟空格，诸如： if / for / while / switch ( statements ) { … } 等

3-1-2. "="前后需要跟空格

3-1-3. 数组成员间的","后面需要跟空格

不好：

for (t in selected) { if (!hash[t]) deselect(t) }

好：

for ( t in selected ) {
if ( !hash[t] ) {
deselect(t); }

3-2. 长语句采用断行:

不好：

templ_songlist.replace('{table}', da['results']).replace('{prev_num}', prev).replace('{next_num}', next).replace('{current_num}', current).replace('{total_num}', da.page_total);

好：

templ_songlist.replace('{table}', da['results']).
replace('{prev_num}', prev).
replace('{next_num}', next).
replace('{current_num}', current).
replace('{total_num}', da.page_total);

3-3. 格式化对象参数：

不好：

embedswf(id, { url: '/swf/player30792.swf?url=' + el.href, width: 261, height: 30, params: { wmode:'transparent' }, attributes: { id: "player-sample" + i, name: "player-sample" + i }});

好：

embedswf(id, {
url: '/swf/player30792.swf?url=' + el.href,
width: 261,
height: 30,
params: { wmode:'transparent' },
attributes: {
id: "player-sample" + i,
name: "player-sample" + i
});