<html>:HTML 文档/根元素

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

属性

该元素包含全局属性

version 已弃用

指定用于组织当前文档的 HTML 文档类型定义的版本。这个属性已不再需要,因为这与文档类型声明中的版本信息重复。

xmlns

指定文档的 XML 命名空间。默认的值是 "http://www.w3.org/1999/xhtml"。这在由 XML 解析器解析的文档中是必需的,而在 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>)也会被正确地宣告。

技术概要

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

规范

Specification
HTML
# the-html-element

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
html
version
Deprecated
xmlns

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Deprecated. Not for use in new websites.

参见

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