<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="en">
  <head>
    <!-- … -->
  </head>
  <body>
    <!-- … -->
  </body>
</html>

無障礙議題

雖然 HTML 不要求作者指定 <html> 元素的開始和結束標籤,但作者這樣做是很重要的,因為這樣可以允許他們為網頁指定 lang。在 <html> 元素上提供一個具有有效語言標籤的 lang 屬性,根據 RFC 5646: 語言識別標籤(或稱 BCP 47),將有助於螢幕閱讀技術確定正確的語言來宣佈。語言識別標籤應該描述頁面內容的大多數使用的語言。如果沒有,螢幕閱讀器通常會默認使用操作系統設置的語言,這可能導致發音錯誤。

<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>