標準元資料名稱

基線 廣泛可用

此功能已得到良好建立,並在許多裝置和瀏覽器版本上執行。它自 2015 年 7 月.

The <meta> element can be used to provide document metadata in terms of name-value pairs, with the name attribute giving the metadata name, and the content attribute giving the value.

HTML 規範中定義的標準元資料名稱

HTML 規範定義了以下標準元資料名稱集

  • application-name: 執行在網頁中的應用程式的名稱。

    注意

    • 瀏覽器可能會使用此名稱來識別應用程式。它不同於 <title> 元素,後者通常包含應用程式名稱,但也可以包含文件名稱或狀態等資訊。
    • 簡單的網頁不應定義 application-name。
  • author: 文件作者的名稱。
  • description: 頁面內容的簡短準確摘要。 搜尋引擎如 Google 可能會使用此欄位來控制網頁在搜尋結果中的顯示方式。
  • generator: 生成頁面的軟體識別符號。
  • keywords: 與頁面內容相關的詞語,用逗號分隔。
  • referrer: 控制從文件傳送的請求的 HTTP Referer 頭部。
    <meta name="referrer">content 屬性的值。
    no-referrer 不要傳送 HTTP Referer 頭部。
    origin 傳送文件的 來源
    no-referrer-when-downgrade 當目標至少與當前頁面一樣安全時(HTTP(S)→HTTPS),傳送完整 URL,但在安全性較低時(HTTPS→HTTP)不傳送任何引用者。 這是預設行為。
    origin-when-cross-origin 對於同源請求傳送完整 URL(去除引數),但對於其他情況只發送來源。
    same-origin 對於同源請求傳送完整 URL(去除引數)。 跨源請求將不包含任何引用者頭部。
    strict-origin 當目標至少與當前頁面一樣安全時(HTTP(S)→HTTPS),傳送來源,但在安全性較低時(HTTPS→HTTP)不傳送任何引用者。
    strict-origin-when-cross-origin 對於同源請求傳送完整 URL(去除引數)。 當目標至少與當前頁面一樣安全時(HTTP(S)→HTTPS),傳送來源。 否則不傳送任何引用者。
    unsafe-URL 對於同源或跨源請求傳送完整 URL(去除引數)。

    注意

    • 動態插入 <meta name="referrer">(使用 document.write()appendChild())會使引用者行為不可預測。
    • 當定義了多個衝突的策略時,將應用 no-referrer 策略。
  • theme-color: 指示使用者代理應使用的一種建議顏色,以自定義頁面或周圍使用者介面的顯示效果。 content 屬性包含有效的 CSS <color>。 可以包含具有有效媒體查詢列表的 media 屬性來設定主題顏色元資料應用到的媒體。
  • color-scheme: 指定文件相容的一種或多種配色方案。 瀏覽器將使用此資訊與使用者的瀏覽器或裝置設定一起,來確定用於從背景和前景到表單控制元件和捲軸的所有內容的顏色。 <meta name="color-scheme"> 的主要用途是指示與亮色和暗色模式的相容性以及優先順序順序。 color-schemecontent 屬性的值可以是以下值之一
    normal

    文件不知道配色方案,應使用預設配色方案呈現。

    light, dark, light dark, dark light

    文件支援的一種或多種配色方案。 多次指定相同的配色方案的效果與只指定一次相同。 指定多個配色方案表示第一個方案是文件的優先選擇,但如果使用者更喜歡第二個指定的方案,則該方案是可以接受的。

    only light

    表示文件支援亮色模式,具有亮色背景和暗色前景顏色。 根據規範,only dark 無效,因為強制文件在不真正相容暗色模式的情況下呈現為暗色模式會導致內容不可讀;所有主要瀏覽器在未配置的情況下預設使用亮色模式。

    例如,要指示文件優先使用暗色模式,但也能在亮色模式下正常呈現
    html
    <meta name="color-scheme" content="dark light" />
    
    這在文件級別有效,就像 CSS color-scheme 屬性允許單個元素指定其首選和接受的配色方案一樣。 你的樣式可以使用 prefers-color-scheme CSS 媒體特徵來適應當前配色方案。

其他規範中定義的標準元資料名稱

CSS 裝置自適應規範定義了以下元資料名稱

  • viewport: 提供有關 視窗 的初始大小的提示。
    <meta name="viewport"> 的內容值
    可能的子值 描述
    width 一個正整數或文字 device-width 定義你想讓網站呈現的視窗畫素寬度。
    height 一個正整數或文字 device-height 定義視窗高度。 未被任何瀏覽器使用。
    initial-scale 0.010.0 之間的正數 定義裝置寬度(縱向模式下的 device-width 或橫向模式下的 device-height)與視窗大小之間的比例。
    maximum-scale 0.010.0 之間的正數 定義最大縮放比例。 它必須大於或等於 minimum-scale,否則行為將是未定義的。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。
    minimum-scale 0.010.0 之間的正數 定義最小縮放比例。 它必須小於或等於 maximum-scale,否則行為將是未定義的。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。
    user-scalable yesno 如果設定為 no,則使用者無法縮放網頁。 預設值為 yes。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。
    viewport-fit auto, containcover

    auto 值不會影響初始佈局視窗,整個網頁都是可見的。

    contain 值表示視窗按比例縮放以適合顯示器內最大的內接矩形。

    cover 值表示視窗按比例縮放以填充裝置顯示器。 強烈建議使用 安全區域內邊距 變數來確保重要內容不會出現在顯示器之外。

    警告

    透過將 user-scalable 設定為 no 來停用縮放功能會阻止視力障礙者閱讀和理解頁面內容。

其他元資料名稱

WHATWG Wiki 元擴充套件頁面 包含大量尚未正式接受的非標準元資料名稱;但是,其中一些名稱在實踐中已經非常普遍地使用 - 包括以下內容

  • creator: 文件建立者的名稱,例如組織或機構。 如果有多個建立者,應使用多個 <meta> 元素。
  • googlebot,是 robots 的同義詞,只被 Googlebot(Google 的索引爬蟲)使用。
  • publisher: 文件釋出者的名稱。
  • robots: 協作爬蟲或“機器人”應如何使用頁面的行為。 它是一個逗號分隔的值列表,如下所示
    描述 使用物件
    index 允許機器人索引頁面(預設值)。 所有
    noindex 請求機器人不要索引頁面。 所有
    follow 允許機器人跟隨頁面上的連結(預設值)。 所有
    nofollow 請求機器人不要跟隨頁面上的連結。 所有
    all 等效於 index, follow Google
    none 等效於 noindex, nofollow Google
    noarchive 請求搜尋引擎不要快取頁面內容。 GoogleYahooBing
    nosnippet 阻止在搜尋引擎結果中顯示頁面描述。 GoogleBing
    noimageindex 請求此頁面不要作為已索引影像的引用頁面出現。 Google
    nocache noarchive 的同義詞。 Bing

    注意

    • 只有協作機器人會遵循這些規則。 不要指望透過它們來阻止電子郵件收集器。
    • 機器人仍然需要訪問頁面才能讀取這些規則。 為了防止頻寬消耗,請考慮是否使用robots.txt 檔案更合適。
    • robots <meta> 標籤和 robots.txt 檔案用途不同:robots.txt 控制頁面爬取,不會影響索引或 robots 元資料控制的其他行為。 如果頁面被其他文件引用,則即使無法爬取,它也可能仍然被索引。
    • 如果你想刪除頁面,noindex 會起作用,但只有在機器人再次訪問頁面之後才會起作用。 確保 robots.txt 檔案沒有阻止重新訪問。
    • 一些值是互斥的,例如 indexnoindex,或 follownofollow。 在這些情況下,機器人的行為是未定義的,並且它們之間可能有所不同。
    • 一些爬蟲機器人,如 Google、Yahoo 和 Bing,支援 HTTP 頭部 X-Robots-Tag 的相同值;這允許非 HTML 文件(如影像)使用這些規則。

規範

規範
HTML 標準
# standard-metadata-names
引用者策略
# referrer-policy-delivery-meta

瀏覽器相容性

BCD 表格僅在瀏覽器中載入

另請參閱