一、HTML 代码约定
web 开发者常常不确定在 HTML 中使用的代码样式和语法。
在 2000 年至 2010 年之间,许多 web 开发者从 HTML 转换为 XHTML。
通过 XHTML,开发者不得不编写有效的“格式良好的”代码。
HTML5 在代码验证时会更宽松一点。
通过 HTML5,您必须创建属于自己的最佳实践、样式指南和代码约定。
二、智能且有未来保证
对样式的合乎逻辑的使用,可以令其他人更容易理解和使用您的 HTML。
在未来,诸如 XML 阅读器之类的程序,也许需要阅读您的 HTML。
使用格式良好的“近似 XHTML 的”语法,能够更智能。
注释:请始终保持您的样式智能、整洁、纯净、格式良好。
三、请使用正确的文档类型
请始终在文档的首行声明文档类型。
四、请使用小写元素名
HTML5 允许在元素名中使用混合大小写字母。
我们推荐使用小写元素名:
- 混合大小写名称并不好
- 开发者习惯使用小写名(比如在 XHTML 中)
- 小写更起来更纯净
- 小写更易书写
五、关闭所有 HTML 元素
在 HTML5 中,您不必关闭所有元素(例如 <p> 元素)。
我们建议关闭所有 HTML 元素。
六、关闭空的 HTML 元素
在 HTML5 中,关闭空元素是可选的。
斜杠(/)在 XHTML 和 XML 中是必需的。
如果您期望 XML 软件来访问您的页面,保持这个习惯是个好主意。
七、属性值加引号
HTML5 允许不加引号的属性值。
我们推荐属性值加引号:
- 如果属性值包含值,则必须使用引号
- 混合样式绝对不好
- 加引号的值更易阅读
八、必需的属性
请始终对图像使用 alt 属性。当图像无法显示时该属性很重要。
请始终定义图像尺寸。这样做会减少闪烁,因为浏览器会在图像加载之前为图像预留空间。
九、空格和等号
等号两边的空格是合法的,但是精简空格更易阅读。
十、避免长代码行
当使用 HTML 编辑器时,通过左右滚动来阅读 HTML 代码很不方便。
请尽量避免代码行超过 80 个字符。
十一、空行和缩进
请勿毫无理由地增加空行。
为了提高可读性,请增加空行来分隔大型或逻辑代码块。
为了提高可读性,请增加两个空格的缩进。请勿使用 TAB。
请勿使用没有必要的空行和缩进。没有必要在短的和相关项目之间使用空行,也没有必要缩进每个元素。
十二、省略 <html> 和 <body>
在 HTML5 标准中,能够省略 <html> 标签和 <body> 标签。
我们不推荐省略 <html> 和 <body> 标签。
<html> 元素是文本的根元素。它是规定页面语言的理想位置。
对于可访问应用程序(屏幕阅读器)和搜索引擎,声明语言很重要。
省略 <html> 或 <body> c可令 DOM 和 XML 软件崩溃。
省略 <body> 会在老式浏览器(IE9)中产生错误。
十三、省略 <head>
在 HTML5 标准中,<head> 标签也能够被省略。
默认地,浏览器会把 <body> 之前的所有元素添加到默认的 <head> 元素。
通过省略 <head> 标签,您能够降低 HTML 的复杂性
注释:对于 web 开发者,省略标签的做法是陌生的。建立规则需要时间。
十四、元数据
<title> 元素在 HTML5 中是必需的。请尽可能制作有意义的标题。
为了确保恰当的解释,以及正确的搜索引擎索引,在文档中对语言和字符编码的定义越早越好。
十五、HTML 注释
短注释应该在单行中书写,并在 <!-- 之后增加一个空格,在 --> 之前增加一个空格;长注释,跨越多行,应该通过 <!-- 和 --> 在独立的行中书写。长注释更易观察,如果它们被缩进两个空格的话。
十六、样式表
请使用简单的语法来链接样式表(type 属性不是必需的)。短规则可以压缩为一行;长规则应该分为多行。
- 开括号与选择器位于同一行
- 在开括号之前用一个空格
- 使用两个字符的缩进
- 在每个属性与其值之间使用冒号加一个空格
- 在每个逗号或分号之后使用空格
- 在每个属性值对(包括最后一个)之后使用分号
- 只在值包含空格时使用引号来包围值
- 把闭括号放在新的一行,之前不用空格
- 避免每行超过 80 个字符
注释:在逗号或分号之后添加空格,是所有书写类型的通用规则。
十七、通过 JavaScript 访问 HTML 元素
使用“不整洁”的 HTML 样式的后果,是可能会导致 JavaScript 错误。
这两个 JavaScript 语句会产生不同的结果。
如果可能,请在 HTML 中使用(与 JavaScript)相同的命名约定。
十八、使用小写文件名
大多数 web 服务器(Apache、Unix)对文件名的大小写敏感:不能以 london.jpg 访问 London.jpg。
其他 web 服务器(微软,IIS)对大小写不敏感:能够以 london.jpg 或 London.jpg 访问 London.jpg。
如果使用混合大小写,那么您必须保持高度的一致性。
如果您从对大小写不敏感的服务器转到一台对大小写敏感的服务器上,这些小错误将破坏您的网站。
为了避免这些问题,请始终使用小写文件名(如果可以的话)。
十九、文件扩展名
HTML 文件名应该使用扩展名 .html(而不是 .htm)。
CSS 文件应该使用扩展名 .css。
JavaScript 文件应该使用扩展名 .js。