2024年4月14日发(作者：)

HTML & JavaScript编码规范 - 1 -

HTML & JavaScript编码规范

1. 简介

1.1 总则

编码规范用于提供统一编码标准，旨在指导翰子昂实训体系学生的源代码文件的规范化，

以保证开发团队的协作和系统的后期维护能有效进行，编码规范同时可作为代码评审的依据。

1.2 目的

本规范提供一个HTML与JavaScript编码的统一标准，目的在于在软件开发过程中基于

HTML与JavaScript的代码在整个开发团队中能够始终保持一致。

1.3 适用范围

本规范适用于翰子昂实训体系内所有应用HTML与JavaScript代码的项目开发与评审活

动。

2. 格 式

2.1 缩进

1. 最高一级的父标记采用左对齐顶格格式书写。

2. 下一级标记采用左对齐向右缩进一个TAB的格式书写。再下一级依此类推，分别左

对齐相对于父标记向右缩进一个TAB的格式书写。

3. 同一级标记的首字符上下必须对齐。

4. 首行缩进不要使用空格来达到效果，规范的做法是在样式表中定义p {text-indent: 2e

m;} 然后给每一段加上

标记，注意，一般情况下，请不要省略

结束标记 。

2.2 排版

1. 不同语种的文字之间应该有一个半角空格，但避头的符号之前和避尾的符号之后除外

汉字之间的标点要用全角标点，英文字母和数字周围的括号应该使用半角括号。

2. 为了最大程度的发挥浏览器自动排版的功能，在一段完整的文字中请尽量不要使用<

br> 来人工干预分段。

3. 所有的字号都应该用样式表来实现，禁止在页面中出现标记。

4. 请不要在网页中连续出现多于一个的空格，也尽量少使用全角空格（英文字符集下，

全角空格会变成乱码），空白应该尽量使用text-indent，padding，margin，hspace，vspace

以及透明的gif图片来实现。

5. 中英文混排时，我们尽可能的将英文和数字定义为verdana和arial两种字体。

6. 行距建议用百分比来定义，常用的两个行距的值是line-height:120%/150%。

2.3 标记换行

一个标记必须占用一行。不得出现两个标记在同一行的情况（同一标记的关闭标记除外）。

- 2 - HTML & JavaScript编码规范

例如：

#001 text

而必须写成：

#001

#002 text

#003

2.4 属性赋值

对于接受属性的标记，属性值必须使用双引号或者单引号包围。如：

#001

#002

2.5 标记关闭

1. 静态文件内容必须包含在标记中间

2. 标记必须包含在标记中间

3. 对于需要关闭的标记，如：