HTML <html> 元素表示 HTML 文档的根(顶级元素),所以它也被称为根元素。其他所有元素必须是此元素的后代。
属性
该元素包含全局属性。
version- : 指定用于组织当前文档的 HTML Doctype的版本。这个属性已不再需要,因为这与文档类型声明中的版本信息重复。
xmlns- : 指定文档的 XML Namespace。默认的值是
"http://www.w3.org/1999/xhtml"。这在由 XML parser解析的文档中是必需的,而在 text/html 文档中是可选的。
- : 指定文档的 XML Namespace。默认的值是
示例
<!doctype html>
<html lang="zh">
<head>
</head>
<body>
</body>
</html>
无障碍考虑
虽然 HTML 并不要求作者指定 <html> 元素的开始和结束标记,但作者必须这样做,因为这将允许他们为网页指定 lang。根据 ,在 <html> 元素上提供一个带有有效语言标记的 lang 属性,将有助于屏幕阅读技术确定要宣告的适当语言。标识语言标签应描述页面大部分内容所使用的语言。如果没有它,屏幕阅读器通常会默认使用操作系统设置的语言,这可能会导致发音错误。
在 <html> 元素中包含一个有效的 lang 声明,还可以确保页面的 head 中包含的重要元数据(如页面的 title)也会被正确地宣告。
技术概要
<table class="properties"> <tbody> <tr> <th scope="row"><a href="/zh-CN/docs/Web/HTML/Guides/Content_categories">内容分类</a></th> <td>无</td> </tr> <tr> <th scope="row">允许的内容</th> <td>一个 head 元素,后跟一个 body 元素</td> </tr> <tr> <th scope="row">标签省略</th> <td> 如果 <code><html></code> 元素中的第一个元素不是注释,则可以省略开始标签。<br> 如果 <code><html></code> 元素没有紧接着注释,则可以省略结束标签。 </td> </tr> <tr> <th scope="row">允许的父元素</th> <td>无。这是文档的根元素。</td> </tr> <tr> <th scope="row">隐式 ARIA 角色</th> <td> <a href="/zh-CN/docs/Web/Accessibility/ARIA/Roles/Document_role" >document</a > </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td>没有允许的角色(<code>role</code>)</td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLHtmlElement</td> </tr> </tbody> </table>
规范
浏览器兼容性
参见
- MathML 顶级元素:math
- SVG 顶级元素:svg
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
