Html Style Guide
User Manual:
Open the PDF directly: View PDF .
Page Count: 18
Download | ![]() |
Open PDF In Browser | View PDF |
HTML编码规范 1 前言 2 代码风格 2.1 缩进与换行 2.2 命名 2.3 标签 2.4 属性 3 通用 3.1 DOCTYPE 3.2 编码 3.3 CSS 和 JavaScript 引入 4 head 4.1 title 4.2 favicon 4.3 viewport 5 图片 6 表单 6.1 控件标题 6.2 按钮 6.3 可访问性 (A11Y) 7 多媒体 8 模板中的 HTML 1 前言 HTML 作为描述网页结构的超文本标记语言,在百度一直有着广泛的应用。 本文档的目标是使 HTML 代码风格保持一致,容易被理解和被维护。 2 代码风格 2.1 缩进与换行 [强制] 使用 2 个空格做为一个缩进层级,不允许使用 4 个空格 或 tab 字 符。 解释: 对于非 HTML 标签之间的缩进,比如 script 或 style 标签内容缩进,与 script 或 style 标签的缩进同级。 示例:
- first
- second
Hello StyleGuide!
Hello StyleGuide!
[强制] 对于无需自闭合的标签,不允许自闭合。 解释: 常见无需自闭合标签有 input 、 br 、 img 、 hr 等。 示例: [强制] 对 HTML5 中规定允许省略的闭合标签,不允许省略闭合标签。 解释: 对代码体积要求非常严苛的场景,可以例外。比如:第三方页面使用的投放 系统。 示例:- first
- second
- first
- second
Esprima serves as an important building block for some JavaS
Esprima serves as an important building block f
[建议] 在 CSS 可以实现相同需求的情况下不得使用表格进行布局。
解释:
在兼容性允许的情况下应尽量保持语义正确性。对网格对齐和拉伸性有严格
要求的场景允许例外,如多列复杂表单。
[建议] 标签的使用应尽量简洁,减少不必要的标签。
示例:
2.4 属性
[强制] 属性名必须使用小写字母。
示例:
...
...
[强制] 属性值必须用双引号包围。
解释:
不允许使用单引号,不允许不使用引号。
示例:
[建议] 布尔类型的属性,建议不添加属性值。
示例:
[建议] 自定义属性建议以 xxx- 为前缀,推荐使用 data- 。
解释:
使用前缀有助于区分自定义属性和标准定义的属性。
示例:

