<html>:HTML 文档/根元素

HTML <html> 元素表示一个 HTML 文档的根(顶级元素),所以它也被称为根元素。所有其他元素必须是此元素的后代。

内容分类
允许的内容 一个 <head> 元素,后跟一个 <body> 元素
忽略标签 如果 <html> 元素中的第一个元素不是注释,则可以忽略开始标签。
如果 <html> 元素没有紧接着注释,则可以忽略结束标签。
允许的父元素 无。这是文档的根元素。
隐式 ARIA 角色 document (en-US)
允许的 ARIA 角色
DOM 接口 HTMLHtmlElement

属性

元素包含全局属性

manifest 已弃用 非标准

指定一个资源清单的 URI,指示应在本地缓存的资源。

version 已弃用

指定控制当前文档的 HTML 版本文档类型定义。这个属性已不再需要,因为这在文档类型声明中是多余的版本信息。

xmlns

指派文档的 XML 命名空间 (en-US)。默认的值是"http://www.w3.org/1999/xhtml"。这在由 XML 解析器 (en-US)解析的文档中是必需的,而在 text/html 文档中是可选的。

示例

html
<!doctype html>
<html lang="zh">
  <head>
    <!-- … -->
  </head>
  <body>
    <!-- … -->
  </body>
</html>

无障碍考虑

虽然 HTML 并不要求作者指定 <html> 元素的开始和结束标记,但作者必须这样做,因为这将允许他们为网页指定 lang。根据 RFC 5646: 识别语言的标签(也称为 BCP 47),在 <html> 元素上提供一个带有有效语言标记的 lang 属性,将有助于屏幕阅读技术确定要发布的适当语言。标识语言标签应描述页面大部分内容所使用的语言。如果没有它,屏幕阅读器通常会默认使用操作系统设置的语言,这可能会导致发音错误。

<html> 元素中包含一个有效的 lang 声明,还可以确保页面的 <head> 中包含的重要元数据,如页面的 <title>,也会被正确地声明。

规范

Specification
HTML Standard
# the-html-element

浏览器兼容性

BCD tables only load in the browser

参见

  • MathML 顶级元素:<math>
  • SVG 顶级元素:<svg>