1. 面向开发者的 Web 技术
  2. HTML（超文本标记语言）
  3. HTML 参考
  4. HTML 元素参考
  5. <html>

此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

<html>：HTML 文档/根元素

基线 广泛可用

自 2015年7月 起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

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

规范

规范
HTML
# the-html-element

浏览器兼容性

参见

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

帮助改进 MDN

了解如何参与贡献

此页面最后更新于 ，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题