HTML5样式指南\代码约定与使用规范

1.HTML代码约定
web开发者常常不确定在HTML中使用的代码样式和语法。在2000年至2010年之间,许多web开发者从HTML转换为XHTML。通过XHTML,开发者不得不编写有效的“格式良好的”代码。HTML5在代码验证时会更宽松一点。通过HTML5,您必须创建属于自己的最佳实践、样式指南和代码约定。
 
2.智能且有未来保证
对样式的合乎逻辑的使用,可以令其他人更容易理解和使用您的HTML。在未来,诸如 XML 阅读器之类的程序,也许需要阅读您的HTML。使用格式良好的“近似 XHTML 的”语法,能够更智能。请始终保持您的样式智能、整洁、纯净、格式良好。
 
3.使用正确的文档类型
要始终在文档的首行声明文档类型:<!DOCTYPE html>
如果您一贯坚持小写标签,那么可以使用:<!doctype html>
 
4.使用小写元素名
HTML5允许在元素名中使用混合大小写字母。推荐使用小写元素名,因为混合大小写名称并不好、开发者习惯使用小写名(比如在 XHTML 中)、小写更起来更纯净、小写更易书写。
<section> 
  <p>This is a paragraph.</p>
</section>
 
5.关闭所有HTML元素
在HTML5中,您不必关闭所有元素(例如 <p> 元素)。建议关闭所有HTML元素:
<section>
  <p>This is a paragraph.</p>
  <p>This is a paragraph.</p>
</section>
 
6.关闭空的HTML元素
在HTML5中,关闭空元素是可选的。<meta charset="utf-8" />
 
7.使用小写属性名
HTML5允许大小写混合的属性名。建议使用小写属性名,因为混合属性名并不好、开发者习惯于使用小写属性名(比如在 XHTML中)、小写属性名看情况更纯净、小写属性名更易书写。
<div class="menu">
 
8.属性值加引号
HTML5允许不加引号的属性值。推荐属性值加引号,如果属性值包含值,则必须使用引号;混合样式绝对不好;加引号的值更易阅读。
<table class="table striped">
 
9.必需的属性
要始终对图像使用alt属性。当图像无法显示时该属性很重要。
<img src="html5.gif" alt="HTML5" style="width:128px;height:128px">
要始终定义图像尺寸。这样做会减少闪烁,因为浏览器会在图像加载之前为图像预留空间。
<img src="html5.gif" alt="HTML5" style="width:128px;height:128px">
 
10.空格和等号
等号两边的空格是合法的:<link rel = "stylesheet" href = "styles.css">
但是精简空格更易阅读:<link rel="stylesheet" href="styles.css">
 
11.避免长代码行
当使用HTML编辑器时,通过左右滚动来阅读HTML代码很不方便。请尽量避免代码行超过80个字符。
 
12.空行和缩进
不要毫无理由地增加空行。为了提高可读性,要增加空行来分隔大型或逻辑代码块。为了提高可读性,要增加两个空格的缩进。请勿使用 TAB。不要使用没有必要的空行和缩进。没有必要在短的和相关项目之间使用空行,也没有必要缩进每个元素:
 
<body>
<h1>Famous Cities</1>
<h2>Tokyo</h2>
<p>
Tokyo is the capital of Japan, the center of the Greater Tokyo Area,
and the most populous metropolitan area in the world.
It is the seat of the Japanese government and the Imperial Palace,
and the home of the Japanese Imperial Family.
</p>
</body>
 
表格示例:
<table>
  <tr>
    <th>Name</th>
    <th>Description</th>
  <tr>
  <tr>
    <td>A</td>
    <td>Description of A</td>
  <tr>
  <tr>
    <td>B</td>
    <td>Description of B</td>
  <tr>
</table>
 
列表示例:
<ol>
  <li>LondonA</li>
  <li>Paris</li>
  <li>Tokyo</li>
</ol>
 
13.省略<html>和<body>?
在HTML5标准中,能够省略<html>标签和<body>标签。但是,不推荐省略<html>和<body>标签。
<html>元素是文本的根元素。它是规定页面语言的理想位置。
<!DOCTYPE html>
<html lang="en-US">
对于可访问应用程序(屏幕阅读器)和搜索引擎,声明语言很重要。
省略<html>或<body>可令DOM和XML软件崩溃。省略<body>会在老式浏览器(IE9)中产生错误。
 
14.省略 <head>?
在HTML5标准中,<head>标签也能够被省略。默认地,浏览器会把<body>之前的所有元素添加到默认的<head>元素。通过省略<head>标签,能够降低HTML的复杂性:
<!DOCTYPE html>
<html>
<title>Page Title</title>
<body>
  <h1>This is a heading</h1>
  <p>This is a paragraph.</p>
</body>
</html>
对于web开发者,省略标签的做法是陌生的。建立规则需要时间。
 
15.元数据
<title>元素在HTML5中是必需的。尽可能制作有意义的标题。
<title>HTML5 Syntax and Coding Style</title>
为了确保恰当的解释,以及正确的搜索引擎索引,在文档中对语言和字符编码的定义越早越好:
<!DOCTYPE html>
<html lang="en-US">
<head>
  <meta charset="UTF-8">
  <title>HTML5 Syntax and Coding Style</title>
</head>
 
16.HTML注释
短注释应该在单行中书写,并在 <!-- 之后增加一个空格,在 --> 之前增加一个空格:
<!-- This is a comment -->
长注释,跨越多行,应该通过<!-- 和 -->在独立的行中书写:
<!-- 
  This is a long comment example. This is a long comment example. This is a long comment example.
  This is a long comment example. This is a long comment example. This is a long comment example.
-->
长注释更易观察,如果它们被缩进两个空格的话。
 
17.样式表
要使用简单的语法来链接样式表(type 属性不是必需的):<link rel="stylesheet" href="styles.css">
短规则可以压缩为一行,就像这样:p.into {font-family:"Verdana"; font-size:16em;}
长规则应该分为多行:
body {
  background-color: lightgrey;
  font-family: "Arial Black", Helvetica, sans-serif;
  font-size: 16em;
  color: black;
}
开括号与选择器位于同一行;在开括号之前用一个空格;使用两个字符的缩进;在每个属性与其值之间使用冒号加一个空格;在每个逗号或分号之后使用空格;在每个属性值对(包括最后一个)之后使用分号;只在值包含空格时使用引号来包围值;把闭括号放在新的一行,之前不用空格;避免每行超过80个字符。
注释:在逗号或分号之后添加空格,是所有书写类型的通用规则。
 
18.在HTML中加载JavaScript
使用简单的语法来加载外部脚本(type 属性不是必需的):<script src="myscript.js">
通过JavaScript访问HTML元素,使用“不整洁”的HTML样式的后果,是可能会导致 JavaScript 错误。这两个JavaScript语句会产生不同的结果:
var obj = getElementById("Demo")
var obj = getElementById("demo")
如果可能,在HTML中使用(与 JavaScript)相同的命名约定。
 
19.使用小写文件名
大多数web服务器(Apache、Unix)对文件名的大小写敏感:不能以london.jpg访问London.jpg。其他web服务器(微软,IIS)对大小写不敏感:能够以london.jpg或London.jpg访问London.jpg。如果使用混合大小写,那么必须保持高度的一致性。如果从对大小写不敏感的服务器转到一台对大小写敏感的服务器上,这些小错误将破坏网站。为了避免这些问题,请始终使用小写文件名(如果可以的话)。
 
20.文件扩展名
HTML文件名应该使用扩展名.html(而不是.htm)。CSS 文件应该使用扩展名.css。JavaScript文件应该使用扩展名.js。