Altq's blog

HTML 代码规范-Auto团队版

1/13/2022 note

前端开发规范, 摘抄自京东凹凸团队版规范

# HTML 代码规范

融合京东凹凸团队版

Markup Validation Service (opens new window)

DOCTYPE 声明

一个 DOCTYPE 必须包含以下部分，并严格按照顺序出现：

  1. A string that is an ASCII case-insensitive match for the string “<!DOCTYPE”.
  2. One or more space characters.
  3. A string that is an ASCII case-insensitive match for the string “html”.
  4. Optionally, a DOCTYPE legacy string or an obsolete permitted DOCTYPE string (defined below).
  5. Zero or more space characters.
  6. A “>” (U+003E) character.
  1. 一个 ASCII 字符串 “<!DOCTYPE” ，大小写不敏感
  2. 一个或多个空白字符
  3. 一个 ASCII 字符串”html”，大小写不敏感
  4. 一个可选的历史遗留的 DOCTYPE 字符串 （DOCTYPE legacy string），或者一个可选的已过时但被允许的 DOCTYPE 字符串 （obsolete permitted DOCTYPE string） 字符串
  5. 一个或多个空白字符
  6. 一个编码为 U+003E 的字符 “>”

# 团队约定

HTML 文件必须加上 DOCTYPE 声明，并统一使用 HTML5 的文档声明：

<!DOCTYPE html>
1

# 更多关于 DOCTYPE 声明 HTML 版本

从 Web 诞生早期至今，已经发展出多个 HTML 版本：

版本 年份
HTML 1991
HTML+ 1993
HTML 2.0 1995
HTML 3.2 1997
HTML 4.01 1999
XHTML 1.0 2000
HTML5 2012
XHTML5 2013

# 常用的声明

# HTML5

<!DOCTYPE html>
1

# HTML 4.01

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
1
2

# XHTML 1.0

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1
2

# 页面语言 LANG

Lang 属性的取值应该遵循互联网工程任务组–IETF（The Internet Engineering Task Force）制定的关于语言标签的文档 BCP 47 - Tags for Identifying Languages (opens new window)

# 团队约定

推荐使用属性值 en 属性值，凹凸团队使用 zh-CN，还是建议使用 en 更多地区语言参考：

zh-CN 中文 (简体, 大陆)
zh-SG 中文 (简体, 新加坡)
zh-HK 中文 (繁体, 香港)
zh-MO 中文 (繁体, 澳门)
zh-TW 中文 (繁体, 台湾)
1
2
3
4
5

# 已废弃不推荐使用的 Languages Tags

以下写法已于 2009 年废弃，请勿使用（cmn、wuu、yue、gan 等已由 2005 年的 extlang 升级到 2009 年的 language）：

zh-cmn, zh-cmn-Hans, zh-cmn-Hant, zh-wuu, zh-yue, zh-gan
1

以下写法已于 2009 年废弃，不推荐使用：

zh-Hans, zh-Hans-CN, zh-Hans-SG, zh-Hans-HK, zh-Hans-MO, zh-Hans-TW,
zh-Hant, zh-Hant-CN, zh-Hant-SG, zh-Hant-HK, zh-Hant-MO, zh-Hant-TW
1
2

更多已废弃 Languages Tags 参考 IANA Language Subtag Registry (opens new window) 里面的 “Type: redundant“”

# 更多关于 Languages Tags ：

W3C Language tags in HTML and XML (opens new window)

网页头部的声明应该是用 lang=”zh” 还是 lang=”zh-cn”？ (opens new window)

# CHARSET

Because the character sets in ISO-8859 was limited in size, and not compatible in multilingual environments, the Unicode Consortium developed the Unicode Standard.

The Unicode Standard covers (almost) all the characters, punctuations, and symbols in the world.

Unicode enables processing, storage, and transport of text independent of platform and language.

The default character encoding in HTML-5 is UTF-8.

因为 ISO-8859 中字符集大小是有限的，且在多语言环境中不兼容，所以 Unicode 联盟开发了 Unicode 标准。

Unicode 标准覆盖了（几乎）所有的字符、标点符号和符号。

Unicode 使文本的处理、存储和运输，独立于平台和语言。

HTML-5 中默认的字符编码是 UTF-8

参阅 HTML Unicode (UTF-8) Reference (opens new window)

# 团队约定

一般情况下统一使用 “UTF-8” 编码

<meta charset="UTF-8">
1

由于历史原因，有些业务可能会使用 “GBK” 编码

<meta charset="GBK">
1

请尽量统一写成标准的 “UTF-8”，不要写成 “utf-8” 或 “utf8” 或 “UTF8”。根据 IETF 对 UTF-8 的定义 (opens new window)，其编码标准的写法是 “UTF-8”；而 UTF8 或 utf8 的写法只是出现在某些编程系统中，如 .NET framework 的类 System.Text.Encoding 中的一个属性名就叫 UTF8。

# 更多关于

UTF-8 写法: UTF8 or UTF-8? (opens new window)

GBK：Application of IANA Charset Registration for GBK (opens new window)

Charset ：character-encoding-declaration (opens new window)

# 元素及标签闭合

HTML 元素共有以下 6 种：

  • 空元素：area、base、br、col、command、embed、hr、img、input、keygen、link、meta、param、source、track、wbr
  • 原始文本元素：script、style
  • RCDATA 元素：textarea、title
  • 外来元素：来自 MathML 命名空间和 SVG 命名空间的元素。
  • 常规元素：其他 HTML 允许的元素都称为常规元素。
  • 模板元素：template。

元素标签的闭合应遵循以下原则：

Tags are used to delimit the start and end of elements in the markup. Raw text, escapable raw text, and normal elements have a start tag to indicate where they begin, and an end tag to indicate where they end. The start and end tags of certain normal elements can be omitted, as described below in the section on optional tags. Those that cannot be omitted must not be omitted. Void elements only have a start tag; end tags must not be specified for void elements. Foreign elements must either have a start tag and an end tag, or a start tag that is marked as self-closing, in which case they must not have an end tag.

  • 原始文本元素、RCDATA 元素以及常规元素都有一个开始标签来表示开始，一个结束标签来表示结束。
  • 某些元素的开始和结束标签是可以省略的 (opens new window)，如果规定标签不能被省略，那么就绝对不能省略它。
  • 空元素只有一个开始标签，且不能为空元素设置结束标签。
  • 外来元素可以有一个开始标签和配对的结束标签，或者只有一个自闭合的开始标签，且后者情况下该元素不能有结束标签。

# 团队约定

为了能让浏览器更好的解析代码以及能让代码具有更好的可读性，有如下约定：

  • 所有具有开始标签和结束标签的元素都要写上起止标签，某些允许省略开始标签或和束标签的元素亦都要写上。
  • 空元素标签都不加 “/” 字符, bootstrap 规范

推荐：

<div>
    <h1>我是h1标题</h1>
    <p>我是一段文字，我有始有终，浏览器能正确解析</p>
</div>

<br>
1
2
3
4
5
6

不推荐：

<div>
    <h1>我是h1标题</h1>
    <p>我是一段文字，我有始无终，浏览器亦能正确解析
</div>

<br/>
1
2
3
4
5
6

更多关于元素及标签关闭：#Elements (opens new window)

Last Updated: 1/17/2022, 3:48:57 AM