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

属性

该元素包含全局属性。

  • version {{deprecated_inline}}
    • : 指定用于组织当前文档的 HTML {{glossary("Doctype", "文档类型定义")}}的版本。这个属性已不再需要，因为这与文档类型声明中的版本信息重复。
  • xmlns
    • : 指定文档的 {{glossary("XML")}} {{glossary("Namespace", "命名空间")}}。默认的值是 "http://www.w3.org/1999/xhtml"。这在由 XML {{glossary("parser", "解析器")}}解析的文档中是必需的，而在 text/html 文档中是可选的。

示例

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

无障碍考虑

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

在 <html> 元素中包含一个有效的 lang 声明，还可以确保页面的 {{HTMLElement("head")}} 中包含的重要元数据（如页面的 {{HTMLElement("title")}}）也会被正确地宣告。

技术概要

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