html语言化规范,HTML编码规范

1.黄金法则(Golden rule)

不管有多少人参与同一个项目&＃xff0c;一定要确保每一行代码都像是同一个人编写的。

Every line of code should appear to be written by a single person, no matter the number of contributors.

这就需要在一个项目中&＃xff0c;我们永远遵循同一套编码规范。在项目开发前&＃xff0c;制定一套行之有效的编码规范&＃xff0c;每个项目组成员都要按这个规范来编码。

2.命名规范

CSS 文件名使用英文小写&＃xff0c;多个单词时&＃xff0c;中间用下划线(_)连接&＃xff0c;如&＃xff1a;index.html web-guide.html

id 命名使用英文驼峰命名法&＃xff0c;多采用语义化来命名

自定义属性采用英文小写命名&＃xff0c;多个单词时&＃xff0c;中间用中划线(-)连接&＃xff0c;如&＃xff1a;generate-catalogue

以 data- 开始的属性名&＃xff0c;是用来存储数据的&＃xff0c;具体可参考 W3C Html 5 data- 。html可以通过 dataset 来取属性中的值&＃xff0c;对于不支持的浏览器&＃xff0c;可以通过getAttribute来获取。例如&＃xff1a;data-city&＃61;"ShangHai" &＃xff0c;如果对应的html标签id为 cityList&＃xff0c;则 document.getElementById(&＃39;cityList&＃39;).dataset(&＃39;city&＃39;); 对于不支持的浏览器&＃xff0c;应该document.getElementById(&＃39;cityList&＃39;).getAttribute(&＃39;-data-city&＃39;);

3.书写规范

3.1 语法

使用两个空格来代替制表符(tab)作为缩进&＃xff0c;— 这是保证代码在各种环境下显示一致的唯一方式

嵌套元素应当缩进一次(即两个空格)

对于属性中的值&＃xff0c;确保全部使用双引号&＃xff0c;不要使用单引号&＃xff0c;也不要省略引号

不要在自闭合(self-closing)元素的尾部添加斜线 — HTML5 规范 中明确说明这是可选的

不要省略可选的结束标签(closing tag)(例如&＃xff0c; 或