Extjs4推荐的js编写各种命名规范(译文档)
2011-11-30 10:00
330 查看
JS命名规范
1.类
类名之包含字符和数字,数字是允许的但不被鼓励使用,除非它确实需要或者出于技术目的。 不要使用下划线,破折线,或者其他非字母和数字的字符。
For example:
MyCompany.useful_util.Debug_Toolbar 是不提倡的
MyCompany.util.Base64 is acceptable 是可忍受的
类名应当正确和适当地使用"."分组起来,最低限度要有一个顶层的包。
For example:
MyCompany.data.CoolProxy
MyCompany.Application
只有最上层以及类名应该使用CamelCased,其他的都应该全小写:
For example:
MyCompany.form.action.AutoLoad
永远也不提倡使用Ext作为你的命名空间。
另外,类名中即便是英文缩写的单词,也必须遵守CamelCased。
For example:
Ext.data.JsonProxy instead of Ext.data.JSONProxy
MyCompany.util.HtmlParser instead of MyCompary.parser.HTMLParser
MyCompany.server.Http instead of MyCompany.server.HTTP
2.源文件
类名应该和JS文件路径互相映射,因此,每个类必须保证单独存放在一个文件中,
For example:
Ext.util.Observable is stored in path/to/src/Ext/util/Observable.js
Ext.form.action.Submit is stored in path/to/src/Ext/form/action/Submit.js
MyCompany.chart.axis.Numeric is stored in path/to/src/MyCompany/chart/axis/Numeric.js
3.方法与变量
与类名类似的,方法和变量名只能包含普通字母和数字,并且数字是允许的但不被鼓励使用,除非它确实需要或者出于技术目的。 不要使用下划线,破折线,或者其他非字母和数字的字符。
方法名和变量名必须保证用camelCased.对于英文缩写同样有效。
Examples
Acceptable method names: encodeUsingMd5() getHtml() instead of getHTML() getJsonResponse() instead of getJSONResponse() parseXmlContent() instead ofparseXMLContent()
Acceptable variable names: var isGoodName var base64Encoder var xmlReader var httpServer
4.属性
类的属性命名参照 方法与变量的规则,除了静态成员变量之外。
静态成员变量应当使用全大写模式:
For example:
Ext.MessageBox.YES = "Yes"
Ext.MessageBox.NO = "No"
MyCompany.alien.Math.PI = "4.13"
1.类
类名之包含字符和数字,数字是允许的但不被鼓励使用,除非它确实需要或者出于技术目的。 不要使用下划线,破折线,或者其他非字母和数字的字符。
For example:
MyCompany.useful_util.Debug_Toolbar 是不提倡的
MyCompany.util.Base64 is acceptable 是可忍受的
类名应当正确和适当地使用"."分组起来,最低限度要有一个顶层的包。
For example:
MyCompany.data.CoolProxy
MyCompany.Application
只有最上层以及类名应该使用CamelCased,其他的都应该全小写:
For example:
MyCompany.form.action.AutoLoad
永远也不提倡使用Ext作为你的命名空间。
另外,类名中即便是英文缩写的单词,也必须遵守CamelCased。
For example:
Ext.data.JsonProxy instead of Ext.data.JSONProxy
MyCompany.util.HtmlParser instead of MyCompary.parser.HTMLParser
MyCompany.server.Http instead of MyCompany.server.HTTP
2.源文件
类名应该和JS文件路径互相映射,因此,每个类必须保证单独存放在一个文件中,
For example:
Ext.util.Observable is stored in path/to/src/Ext/util/Observable.js
Ext.form.action.Submit is stored in path/to/src/Ext/form/action/Submit.js
MyCompany.chart.axis.Numeric is stored in path/to/src/MyCompany/chart/axis/Numeric.js
3.方法与变量
与类名类似的,方法和变量名只能包含普通字母和数字,并且数字是允许的但不被鼓励使用,除非它确实需要或者出于技术目的。 不要使用下划线,破折线,或者其他非字母和数字的字符。
方法名和变量名必须保证用camelCased.对于英文缩写同样有效。
Examples
Acceptable method names: encodeUsingMd5() getHtml() instead of getHTML() getJsonResponse() instead of getJSONResponse() parseXmlContent() instead ofparseXMLContent()
Acceptable variable names: var isGoodName var base64Encoder var xmlReader var httpServer
4.属性
类的属性命名参照 方法与变量的规则,除了静态成员变量之外。
静态成员变量应当使用全大写模式:
For example:
Ext.MessageBox.YES = "Yes"
Ext.MessageBox.NO = "No"
MyCompany.alien.Math.PI = "4.13"
相关文章推荐
- EXTJS4自学手册——EXT文件目录,本地加载文档,命名规范
- 软件开发文档编写规范
- 我们团队的数据库命名规范文档
- 代码编写命名规范
- js 编写规范
- 轻松学习JavaScript十九:DOM编程学习之在HTML文档什么位置编写JS代码
- SQL数据库设计规范参考之数据库对象命名详细文档
- EXTJS4官方文档翻译系列一:类系统和编码规范
- css命名规范,js命名规范
- Puppet实战-Puppet主机、模块、类、资源、变量、参数、标签命名规范 推荐
- js 判断各种数据类型的简单方法(推荐)
- JavaScript发展史,与JScript差别,引入方式,数据类型,命名规范,命名推荐,解决命名冲突
- 我翻译的文档----Symbian基本规范:命名约定
- 如何编写基于OpenAPI规范的API文档
- Web前端开发规范文档你需要知道的事--HTML、css、js、文档等需要规范内容
- JS变量的定义及JS的命名规范
- CSS命名规范参考及书写注意事项 (推荐)
- 《移动开发接口及文档编写规范》V1.0
- 规范注释,命名,合理运用文档
- js基础:数据类型,变量命名规范