HTML相关规范
- 使用小写文件名,使用完整的扩展名 .html
- 使用正确的文档类型,为每个HTML文档页面的第一行添加标准模式声明,建议使用小写
<!doctype html>
- 尽量使用语义化标签,更便于团队开发者阅读的同时让浏览器的爬虫和机器很好地解析。
- 使用小写元素名,严禁使用大写或者大小写混用
- 关闭所有HTML元素
<div>...</div>
<p>...</p>
- 自闭和元素尾部斜线可不加
<meta name="..." content="..." >
<img src="..." alt="..." title="..." >
- 使用小写属性名, 属性值用双引号,不要使用单引号。
<div class="menu">...</div>
- 空行和缩进
² 不要无缘无故添加空行;
² 为每个逻辑功能块添加空行,这样更易于阅读;
² 缩进使用2个空格,如过习惯使用TAB,需要设置成两个空格。
- 语言属性
根据 HTML5 规范:强烈建议为 html 根元素指定 lang 属性,从而为文档设置正确的语言。这将有助于语音合成工具确定其所应该采用的发音,有助于翻译工具确定其翻译时所应遵守的规则等等。
<html lang="zh">...</html>
- IE兼容模式
IE 支持通过特定的 <meta> 标签来确定绘制当前页面所应该采用的 IE 版本。除非有强烈的特殊需求,否则最好是设置为 edge mode,从而通知 IE 采用其所支持的最新的模式。
<meta http-equiv="X-UA-Compatible" content="IE=edge">
- 字符编码
通过明确声明字符编码,能够确保浏览器快速并容易的判断页面内容的渲染方式。这样做的好处是,可以避免在 HTML 中使用字符实体标记(character entity),从而全部与文档编码一致(一般采用 UTF-8 编码)。
<meta charset="UTF-8">
- 引入 CSS 和 JavaScript 文件
根据 HTML5 规范,在引入 CSS 和 JavaScript 文件时一般不需要指定 type 属性,因为 text/css 和 text/javascript 分别是它们的默认值。
<link rel="stylesheet" href="styles.css">
<script src="myscript.js">
- 属性顺序
从大到小,HTML 属性应当按照以下给出的顺序依次排列,确保代码的易读性。
① class
② id, name
③ data-*
④ src, for, type, href, value
⑤ title, alt
⑥ role, aria-*
<form class="..." id="" name="..." data-action="..." method="" title="" role="form"></form>
说明:class用于标识高度可复用组件,因此应该排在首位。id 用于标识具体组件,应当谨慎使用因此排在第二位。
- 减少标签的数量
编写 HTML 代码时,尽量避免多余的父元素。很多时候,这需要迭代和重构来实现。
- 减少 JavaScript 生成的标签
通过 JavaScript 生成的标签让内容变得不易查找、编辑,并且降低性能。能避免时尽量避免。
- SEO
² 设定标题和语言,可以让搜索引擎很快了解你页面的主题;
² 设定关键字,搜索引擎在遇到这些关键字时,会用这些关键字对文档进行分类;
² 设定页面描述,是很重要的一个页面优化元素(150字内);
² 使用语义化标签;
² <img>标签必须添加"alt"和"title"属性;
² 规避使用iframe框架。