JavaScript及HTML编程规范.docVIP

JavaScript及HTML编程规范 编号：ISS-STD-JS 版本:1.0 变更记录 日期 版本 变更说明 作者 目录 1 导言 4 1.1 目的 4 1.2 范围 4 1.3 角色和职责 4 2 HTML标记语言编码规范 5 2.1 标记的换行规范 5 2.2 标记的关闭规范 5 2.3 标记的属性赋值规范 5 2.4 标记的缩进规范 6 2.5 注释 6 3 客户端JavaScript规范 7 3.1 变量命名规范 7 3.2 变量使用规范 7 3.3 对象命名规范 8 3.4 函数以及子过程命名规范 8 3.5 注释 8 导言 JSP是一种脚本语言，编码分为两大部分，一部分为静态文件编码，一部分为包含服务器端脚本的动态文件编码。编码?HTML标记语言编码规范标记的换行规范一个标记必须占用一行。不得出现两个标记在同一行的情况(同一标记的关闭标记除外)，如： ???trtdtext/td/tr ?? 而必须写成： ??tr ?tdtext/td /tr ?标记的关闭规范静态文件内容必须包含在body/body标记中间 body标记必须包含在html/html标记中间 ??对于需要关闭的标记，如： ???　　html、title、body、table、tr、td、 p、textarea、select、font、option、div、span 必须同其关闭标记同时出现。如 ???　　body…p…font…./font…./p…../body ?不得出现交叉包含的语句，如： ???pfont…../p/font标记的属性赋值规范对于接受属性的标记，属性值必须使用双引号包围。如: body?bgcolor=”red” ? font?size=”7” 标记的缩进规范最高一级的父标记采用左对齐顶格方式书写。 ?下一级标记采用左对齐向右缩进一个Tab的方式书写 ???　　下一级依此类推，分别左对齐相对于父标记向右缩进一个Tab的方式书写 ?同一级标记的首字符上下必须对齐- - - - 客户端JavaScript规范?变量命名规范常量以及全局变量名必须全部使用大写字母 ???变量名首字母必须小写。 ???变量名必须使用其类型的所写字符串开始。各种类型的所写字符串如下： ???整型变量： ??? ?长整型变量： ??? ?浮点型变量：?? ?双精度变量： ??? ?对象引用变量：obj ??字符串变量:str ???Date类型变量： ??? ?变量名必须采用有意义的单词命名，如： ???strUserName、lngArrayIndex ??变量名除首字母小写外，其他单词首字符必须大写 ?如果变量名过长可以使用单词缩写，除了被广泛了解的单词缩写以外，所有使用单词所写的变量名必须在定义时给出注释,如： ???var?strAdName?//用于表示Administrator帐户的名称 ???var?strAdminName?//不用给出注释，Admin被广泛了解 变量使用规范变量使用前必须定义。没有定义的变量禁止使用 ?? 变量的使用尽量缩小到小的作用域。如循环使用 ???for(var?I=0;I12;I++){ //medthod body } ??? 而不是： ??? var?I; ?? ?for(I=0;I12,I++){ ??? //medthod body } 对象命名规范各种页面对象如text输入框、按钮、下拉选择框在命名时必须使用以下对应前缀： ?text输入框:txt ?button按钮：btn ?select下拉选择框：sel ?option项:opt ?form表单：frm ?frame框架：fra ?hidden表单项：hdn ?div标记：div ?span标记:span ?对话框对象:dlg ?窗口对象：win 函数以及子过程命名规范函数命名必须使用动词＋名词对的方式，并且能够体现函数的功能 ?函数命名的动词前缀必须是同函数功能相关的完整动词 ?函数命名第一个单词的首字母小写，后面每一个单词的首字母大写 JavaScript 及 HTML 编程规范 7 / 8