<meta>:元資料元素

Baseline 廣泛可用 *

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

* 此特性的某些部分可能存在不同級別的支援。

<meta> HTML 元素用於表示其他元資料相關的元素(如 <base><link><script><style><title>)無法表示的 元資料

<meta> 元素提供的元資料型別可以是以下之一:

  • 如果設定了 name 屬性,<meta> 元素會提供適用於整個頁面的文件級元資料
  • 如果設定了 http-equiv 屬性,<meta> 元素將充當pragma指令,模擬原本可以由 HTTP 頭部給出的指令。
  • 如果設定了 charset 屬性,<meta> 元素將是字元集宣告,指示文件所使用的字元編碼。
  • 如果設定了 itemprop 屬性,<meta> 元素將提供使用者自定義元資料

屬性

此元素包含全域性屬性

注意: name 屬性對 <meta> 元素有特定含義。如果 <meta> 元素包含 namehttp-equivcharset 屬性,則不得設定 itemprop 屬性。

字元集

此屬性宣告文件的字元編碼。如果存在此屬性,其值必須與字串 "utf-8" 進行 ASCII 編碼不區分大小寫的匹配,因為 UTF-8 是 HTML5 文件唯一有效的編碼。宣告字元編碼的 <meta> 元素必須完全位於文件的前 1024 位元組內。

content

此屬性包含 http-equivname 屬性的值,具體取決於使用了哪個屬性。

http-equiv

定義一個 pragma 指令,這些指令是瀏覽器處理文件的指示。該屬性的名稱是 http-equivalent 的縮寫,因為允許的值是等效 HTTP 標頭名稱。

媒體

media 屬性定義了 content 屬性中定義的“主題顏色”應應用於哪些媒體。其值是一個 媒體查詢,如果屬性缺失,則預設為 all。此屬性僅在元素的 name 屬性設定為 theme-color 時才相關。否則,它沒有效果,不應包含。

name

namecontent 屬性可以結合使用,以名稱-值對的形式提供文件元資料,其中 name 屬性給出元資料名稱,content 屬性給出值。

示例

設定 meta 描述

以下 <meta> 標籤為網頁提供了一個 description 作為元資料:

html
<meta
  name="description"
  content="The HTML reference describes all elements and attributes of HTML, including global attributes that apply to all elements." />

設定頁面重定向

以下示例使用 http-equiv="refresh" 來指示瀏覽器執行重定向。content="3;url=https://www.mozilla.org" 屬性將在 3 秒後將頁面重定向到 https://www.mozilla.org

html
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

技術摘要

內容類別 元資料內容。如果存在 itemprop 屬性:流內容措辭內容
允許內容 無;它是一個空元素
標籤省略 必須有起始標籤,且不能有結束標籤。
允許父級
隱式 ARIA 角色 沒有對應的角色
允許的 ARIA 角色 不允許 role
DOM 介面 HTMLMetaElement

規範

規範
HTML
# the-meta-element

瀏覽器相容性

另見