Dojo Javascript 编程规范 [1]

---

序

　　Any violation to this guide is allowed if it enhances readability.

　　所有的代码都要变成可供他人容易阅读的。

　　快读参考

　　核心 API 请使用下面的风格：

结构	规则	注释
模块	小写	不要使用多重语义（Never multiple words）
类	骆驼
公有方法	混合	其他的外部调用也可以使用 lower_case()，这样的风格
公有变量	混合
常量	骆驼 或 大写

　　下面的虽然不是必要的，但建议使用：

结构	规则
私有方法	混合，例子：_mixedCase
私有变量	混合，例子：_mixedCase
方法（method）参数	混合，例子：_mixedCase, mixedCase
本地（local）变量	混合，例子：_mixedCase, mixedCase

　　命名规范

　　变量名称 必须为 小写字母。

　　类的命名使用骆驼命名规则，例如：

　　Account, EventHandler

　　常量 必须 在对象（类）或者枚举变量的前部声明。枚举变量的命名必须要有实际的意义，并且其成员 必须 使用骆驼命名规则或使用大写：

var NodeTypes = {
Element : 1,
DOCUMENT: 2
}

　　简写单词 不能使用 大写名称作为变量名：

　　getInnerHtml(), getXml(), XmlDocument

　　方法的命令 必须 为动词或者是动词短语：

　　obj.getSomeValue()

　　公有类的命名 必须 使用混合名称（mixedCase）命名。

　　CSS 变量的命名 必须
 使用其对应的相同的公共类变量。

　　私有类的变量属性成员 必须 使用混合名称（mixedCase）命名，并前面下下划线（_）。例如：

var MyClass = function(){
var _buffer;
this.doSomething = function(){
};
}

　　变量如果设置为私有，则前面 必须 添加下划线。

　　this._somePrivateVariable = statement;

　　通用的变量 必须 使用与其名字一致的类型名称：

　　setTopic(topic) // 变量 topic 为 Topic 类型的变量

　　所有的变量名 必须 使用英文名称。

　　变量如有较广的作用域（large scope），必须使用全局变量；此时可以设计成一个类的成员。相对的如作用域较小或为私有变量则使用简洁的单词命名。

　　如果变量有其隐含的返回值，则避免使用其相似的方法：

　　getHandler(); // 避免使用 getEventHandler()

　　公有变量必须清楚的表达其自身的属性，避免字义含糊不清，例如：

　　MouseEventHandler,而非 MseEvtHdlr

　　请再次注意这条规定，这样做得的好处是非常明显的。它能明确的表达表达式所定义的含义。例如：

　　dojo.events.mouse.Handler // 而非 dojo.events.mouse.MouseEventHandler

　　类/构造函数 可以使用 扩展其基类的名称命名，这样可以正确、迅速的找到其基类的名称：

　　EventHandler

　　UIEventHandler

　　MouseEventHandler

　　基类可以在明确描述其属性的前提下，缩减其命名：

　　MouseEventHandler as opposed to MouseUIEventHandler

---

« 
» 

---