<html>:HTML 文档 / 根元素

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

<html> HTML 元素代表 HTML 文档的根(顶级元素),因此也称为根元素。所有其他元素都必须是该元素的后代。一个文档中只能有一个 <html> 元素。

属性

此元素包含全局属性

version 已弃用

指定管理当前文档的 HTML 文档类型定义的版本。此属性不需要,因为它与文档类型声明中的版本信息重复。

xmlns

指定文档的 XML 命名空间。默认值为 "http://www.w3.org/1999/xhtml"。这在使用 XML 解析器解析的文档中是必需的,而在 text/html 文档中是可选的。

无障碍

虽然 HTML 不需要作者指定 <html> 元素的开始和结束标签,但作者指定它们非常重要,因为这样可以为网页指定 lang 属性。在 <html> 元素上提供带有有效 BCP 47 语言标签lang 属性将有助于屏幕阅读技术确定要播报的正确语言。标识语言标签应描述页面大部分内容所使用的语言。如果没有它,屏幕阅读器通常会默认使用操作系统设置的语言,这可能会导致发音错误。

包含在 <html> 元素上的有效 lang 声明还可以确保页面 <head> 中包含的重要元数据(如页面的 <title>)也能被正确播报。

示例

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

技术摘要

内容类别 无。
允许内容 一个 <head> 元素,后面跟着一个 <body> 元素。
标签省略 如果 <html> 元素内的第一项不是注释,则可以省略开始标签。
如果 <html> 元素后面不是紧跟着注释,则可以省略结束标签。
允许父级 无。这是文档的根元素。
隐式 ARIA 角色 document
允许的 ARIA 角色 不允许 role
DOM 接口 HTMLHtmlElement

规范

规范
HTML
# the-html-element

浏览器兼容性

另见

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