1 / 15
文档名称:

Javascript代码规范.doc

格式:doc   大小:86KB   页数:15页
下载后只包含 1 个 DOC 格式的文档,没有任何的图纸或源代码,查看文件列表

如果您已付费下载过本站文档,您可以点这里二次下载

分享

预览

Javascript代码规范.doc

上传人:drp539605 2019/2/2 文件大小:86 KB

下载得到文件列表

Javascript代码规范.doc

文档介绍

文档介绍:javascript代码规范[键入文档副标题]李博[选取日期] . JavaScript文件 . 版权和版本的声明 . 编码格式 22. 程序的版式 . 空格 . 缩进 . 行宽 . 注释 . 变量声明 . 方法声明 . 命名规则 83. 语句的规范 . 简单语句 . 复杂语句 . 语句实例 . return语句 . if语句 . for语句 . while语句 . do语句 . switch语句 . try语句 . continue语句 . with语句 . 额外建议 . {}和[] . 逗号操作符 . 块作用域 . 赋值表达式 . ===和!==操作符 . 令人混淆的加和减 . 邪恶的eval 。JavaScript代码不应该嵌入在HTML文件里,除非那些代码是一个单独的会话特有的。HTML里的JavaScript代码大大增加了页面的大小,并且很难通过缓存和压缩来缓解。<scriptsrc=””>标签应该在body里越靠后的位置越好。这减少了由于加载script而导致的其它页面组件的延迟。没有必要使用language或者type属性。由服务器而不是script标签来决定MIME类型。版权和版本的声明版权和版本的声明位于文件的开头,以注释的结构出现,如图表11所示:/**可视化网页编辑器***摘要:简要叙述本文件内容以及功能**当前版本:*作者:输入作者(或修改者)名字*完成日期:**年*月*日**取代版本:*原作者:输入原作者(或修改者)名字*完成日期:**年*月*日*/图表11版权和版本声明编码格式所有js文件(以及其他html、css等文件),均使用utf-8编码程序的版式空格空行通过将逻辑相关的代码放到一起来增加可读性。空格应该用于如下情况:关键字后面跟“(”(左圆括号)时应该用一个空格隔开。代码while (true) {  方法名和方法的“(”(左圆括号)之间不要有空格。这利于区分关键字和方法调用。所有的二元操作符,除了“.”(圆点)、“(”(左圆括号)和“[”(左中括号),都应该使用一个空格来和操作数隔开。一元操作符和操作数之间不应该使用空格隔开,除了操作符是一个单词时,如typeof。for语句控制部分的每个“;”(分号)应该在后面跟一个空格。每个“,”(逗号)后面应该跟一个空格。缩进缩进的最小单位是4个空格,4个空格为一个缩进单位。不要使用tab键,一个函数的开始顶格写,进入函数体之后缩进一个单位,进入下一层再缩进一个单位,以此类推,例子如下:FunctiongetAttr(){For(varI=0;I<n;i++){Alert(“hello”);}}所有的“{”和“}”必须缩进的距离都一样,不能出现左括号缩进2个字符,右括号缩进4个字符这样缩进不等的情况。行宽不要让一行代码超过80个字符。当一条语句不能在单独一行写完时,可能有必要拆分它。在操作符后进行拆分,最好是在逗号后面拆分。操作符后面进行拆分减少了通过插入分号伪装copy-paste错误的可能性。下一行应该缩进8个空格。注释每一个函数的开头都应该写上注释,注释的格式为: /* 此函数用于在获取标签字符串之后对该标签进行计息 参数str表示… */(2)对于新定义变量的用途以及关键的语句必须进行单行注释,注释添加的位置可以在上一行,也可以在行末,视情况而定,如果一个语句较长,推荐在上一行进行注释;如果语句较短可以在行末进行注释。(3)对于一个函数的结尾,应该在结尾处加上此函数结束的标志用于表示函数的结束,例如://endoffunctiongetAtrr(4)对于有多层嵌套,应该在最外层以及具有关键意义的层的结尾处添加结束注释,例如:For(varI=…){Varj=0;…If(…){For(vart…){…}}//endofif}//endoffor更新注释非常重要,修改后的代码应该及时的更新注释,函数功能转变了应该及时的更新函数头的注释。(5)让注释有意义。更多的关注于不能马上可见的东西。不要用如下内容浪费读者的时间:代码i = 0; // Set i to zero.  一般使用行注释。把块注释用于正式文档或外部注释。变量声明(1)所有的变量应该在使用前声明