<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 文件的根(頂層元素),因此它也被稱為根元素。所有其他元素都必須是這個元素的後代。

屬性

此元素包括全域屬性

manifest 已棄用

指定了應該在本地緩存的資源清單的 URI

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 Standard
# the-html-element

瀏覽器相容性

BCD tables only load in the browser

參見

  • MathML 的頂層元素:<math>
  • SVG 的頂層元素:<svg>