<html>:HTML 文件 / 根元素

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

<html> HTML 元素代表 HTML 文件的根(頂級元素),因此也稱為根元素。所有其他元素都必須是該元素的後代。一個文件中只能有一個 <html> 元素。

屬性

此元素包含全域性屬性

version 已棄用

指定管理當前文件的 HTML 文件型別定義的版本。此屬性不需要,因為它與文件型別宣告中的版本資訊重複。

xmlns

指定文件的 XML 名稱空間。預設值為 "http://www.w3.org/1999/xhtml"。這在使用 XML 解析器解析的文件中是必需的,而在 text/html 文件中是可選的。

無障礙

雖然 HTML 不需要作者指定 <html> 元素的開始和結束標籤,但作者指定它們非常重要,因為這樣可以為網頁指定 lang 屬性。在 <html> 元素上提供帶有有效 BCP 47 語言標籤lang 屬性將有助於螢幕閱讀技術確定要播報的正確語言。標識語言標籤應描述頁面大部分內容所使用的語言。如果沒有它,螢幕閱讀器通常會預設使用作業系統設定的語言,這可能會導致發音錯誤。

包含在 <html> 元素上的有效 lang 宣告還可以確保頁面 <head> 中包含的重要元資料(如頁面的 <title>)也能被正確播報。

示例

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

技術摘要

內容類別 無。
允許內容 一個 <head> 元素,後面跟著一個 <body> 元素。
標籤省略 如果 <html> 元素內的第一項不是註釋,則可以省略開始標籤。
如果 <html> 元素後面不是緊跟著註釋,則可以省略結束標籤。
允許父級 無。這是文件的根元素。
隱式 ARIA 角色 document
允許的 ARIA 角色 不允許 role
DOM 介面 HTMLHtmlElement

規範

規範
HTML
# the-html-element

瀏覽器相容性

另見

  • MathML 頂級元素:<math>
  • SVG 頂級元素:<svg>