黄金定律:不管有多少人共同参与同一个项目,一定要确保每一行代码都像是同一个人编写的。
注:永远遵循同一套编码规范--可以是这里列出来的,也可以是你自己总结的。(如有发现本规范中有任何错,敬请指正。)
一.语法
- 用两个空格来代替制表符(tab) -- 这是唯一能保证在所有环境下获得一致展现的方法。
- 嵌套元素应当缩进一次(即两个空格)。
- 对于属性的定义,确保全部使用双引号,绝不要使用单引号。
- 不要在自闭合(self-closing)元素的尾部添加斜线 -- HTML5 规范中明确说明这是可选的。
- 不要省略可选的结束标签(closing tag)(例如,
</li>
或</body>
)。
例如下:
二. HTML5 DOCTYPE
为每个HTML页面的第一行添加标准模式(standard mode)的声明,这样能够确保在每个浏览器中拥有一致 的展示。
如下例:
三.语言属性
根据HTML5规范:
强烈建议为HTML根元素指定lang属性,从而为文档设置正确的语言。这将有助于语音合成工具确定其所应该采用的发音,有助于翻译工具确定其翻译是应遵守的规则等等。
如下例:
<html lang="zh-CN">
<!--......-->
</html>
四. IE兼容模式
IE支持通过特定<meta> 标签来确定绘制当前页面所应该采用的IE版本。除非有强烈的特殊需求,否则最好是设置为 edge mode,从而通知IE采用其所支持的最新的模式。
如下代码示例:
<meta http-equiv="X-UA-Compatible" content="IE-Edge">
五. 字符编码
通过明确声明字符编码,能够确保浏览器快速并容易的判断页面内容的渲染方式。这样做的好处是,可以避免在HTML中使用字符实体标记(character entity),从而全部与文档编码一致(一般采用UTF-8编码)。
如下代码示例:
<head><meat charset="UTF-8"></head>
六. 引入CSS 和 javascript文件
根据HTML5规范,在引入CSS和javascript 文件时一般不需要指定type属性,因为text/css 和 text/javascript 分别是他们的默认属性值。
如下代码示例:
七. 实用为王
尽量遵循HTML标准和语义,但是不要以牺牲实用性为代价。任何时候都要尽量使用最少的标签并保持最小的复杂度。
八. 属性顺序
HTML 属性应当按照以下给出的顺序依次排序,确保代码的易读性。
。class
。id,name
。data-*
。src, for, type, href
。title, alt
。aria-*, role
class 用于表示高度可复用组建,因此应该排在首位。Id用于标识具体组件,应当谨慎使用,因此排在第二位。
如下实例:
九. 布尔(boolean) 型属性
布尔型属性可以在声明是不赋值。XHTML规范要求为其赋值,但是HTML5规范不需要。
元素的布尔型属性如果有值,就是true,如果没值,就是false.
如下实例:
十.减少标签的数量
编写HTML 代码时尽量避免多余的父元素。很多时候,这需要迭代和重构来实现。
如下示例:
十一. javascript 生成的标签
通过javascript生成的标签让内容变得不已查找,编辑,并且降低性能。能避免时尽量避免。
本文章参考学习自:http://codeguide.bootcss.com/#html-ie-compatibility-mode 感谢分享。