<meta>：元資料元素

基線 廣泛可用

此功能已得到很好的確立，並且可以在許多裝置和瀏覽器版本中使用。它自以下時間起在瀏覽器中可用 2015 年 7 月.

<meta> HTML 元素表示無法由其他 HTML 元資料相關元素（如 <base>、<link>、<script>、<style> 或 <title>）表示的元資料。

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

  • 如果設定了 name 屬性，則 <meta> 元素提供文件級元資料，適用於整個頁面。
  • 如果設定了 http-equiv 屬性，則 <meta> 元素是pragma 指令，提供的資訊等同於可以使用同名 HTTP 標頭提供的資訊。
  • 如果設定了 charset 屬性，則 <meta> 元素是字元集宣告，提供文件編碼使用的字元編碼。
  • 如果設定了 itemprop 屬性，則 <meta> 元素提供使用者定義的元資料。

屬性

此元素包含全域性屬性。

注意： 屬性 name 對於 <meta> 元素具有特定的含義，並且 itemprop 屬性不得設定在與任何現有 name、http-equiv 或 charset 屬性相同的 <meta> 元素上。

charset

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

content

此屬性包含 http-equiv 或 name 屬性的值，具體取決於使用哪個屬性。

http-equiv

定義一個編譯指示。該屬性名為 http-equiv(alent)，因為所有允許的值都是特定 HTTP 標頭的名稱。

  • content-security-policy 允許頁面作者為當前頁面定義 內容策略。內容策略主要指定允許的伺服器來源和指令碼端點，這有助於防止跨站點指令碼攻擊。
  • content-type 宣告 MIME 型別 和文件的字元編碼。如果指定了 content 屬性，則其值必須為 "text/html; charset=utf-8"。這等效於具有 charset 屬性指定的 <meta> 元素，並在文件中的放置位置上具有相同的限制。注意： 只能在使用 text/html 提供服務的文件中使用 - 不能在使用 XML MIME 型別提供服務的文件中使用。
  • default-style 設定預設 CSS 樣式表 集的名稱。
  • x-ua-compatible 如果指定，則 content 屬性的值必須為 "IE=edge"。使用者代理必須忽略此編譯指示。
  • refresh 此指令指定
    • 頁面應重新載入之前的秒數 - 僅當 content 屬性包含非負整數時。
    • 頁面應重定向到另一個頁面之前的秒數 - 僅當 content 屬性包含非負整數，後跟字串 ';url=' 和有效 URL 時。
    計時器在頁面完全載入時開始，即在 load 和 pageshow 事件都觸發之後。

    警告

    設定了 refresh 值的頁面存在時間間隔過短的風險。使用螢幕閱讀器等輔助技術的使用者可能無法在自動重定向之前閱讀並理解頁面的內容。頁面內容的突然、未經宣佈的更新也可能使視力障礙者感到困惑。

name

name 和 content 屬性可以一起用於根據名稱-值對提供文件元資料，其中 name 屬性提供元資料名稱，content 屬性提供值。

有關 HTML 規範中定義的標準元資料名稱集的詳細資訊，請參閱 標準元資料名稱。

示例

html
<meta charset="utf-8" />

<!-- Redirect page after 3 seconds -->
<meta http-equiv="refresh" content="3;url=https://www.mozilla.org" />

技術摘要

內容類別 元資料內容。如果存在 itemprop 屬性：流內容、短語內容。
允許的內容 無；它是一個 空元素。
標籤省略 必須有開始標籤，並且不得有結束標籤。
允許的父元素
隱式 ARIA 角色 無對應角色
允許的 ARIA 角色 不允許使用 role
DOM 介面 HTMLMetaElement

規範

規範
HTML 標準
# the-meta-element

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱