標準元資料名稱
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: 控制從文件傳送的請求的 HTTPReferer頭部。<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-scheme的content屬性的值可以是以下值之一normal-
文件不知道配色方案,應使用預設配色方案呈現。
light,dark,light dark,dark light-
文件支援的一種或多種配色方案。 多次指定相同的配色方案的效果與只指定一次相同。 指定多個配色方案表示第一個方案是文件的優先選擇,但如果使用者更喜歡第二個指定的方案,則該方案是可以接受的。
only light-
表示文件只支援亮色模式,具有亮色背景和暗色前景顏色。 根據規範,
only dark無效,因為強制文件在不真正相容暗色模式的情況下呈現為暗色模式會導致內容不可讀;所有主要瀏覽器在未配置的情況下預設使用亮色模式。
這在文件級別有效,就像 CSShtml<meta name="color-scheme" content="dark light" />color-scheme屬性允許單個元素指定其首選和接受的配色方案一樣。 你的樣式可以使用prefers-color-schemeCSS 媒體特徵來適應當前配色方案。
其他規範中定義的標準元資料名稱
CSS 裝置自適應規範定義了以下元資料名稱
viewport: 提供有關 視窗 的初始大小的提示。<meta name="viewport">的內容值值 可能的子值 描述 width一個正整數或文字 device-width定義你想讓網站呈現的視窗畫素寬度。 height一個正整數或文字 device-height定義視窗高度。 未被任何瀏覽器使用。 initial-scale0.0到10.0之間的正數定義裝置寬度(縱向模式下的 device-width或橫向模式下的device-height)與視窗大小之間的比例。maximum-scale0.0到10.0之間的正數定義最大縮放比例。 它必須大於或等於 minimum-scale,否則行為將是未定義的。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。minimum-scale0.0到10.0之間的正數定義最小縮放比例。 它必須小於或等於 maximum-scale,否則行為將是未定義的。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。user-scalableyes或no如果設定為 no,則使用者無法縮放網頁。 預設值為yes。 瀏覽器設定可以忽略此規則,iOS10+ 預設情況下會忽略它。viewport-fitauto,contain或coverauto值不會影響初始佈局視窗,整個網頁都是可見的。contain值表示視窗按比例縮放以適合顯示器內最大的內接矩形。cover值表示視窗按比例縮放以填充裝置顯示器。 強烈建議使用 安全區域內邊距 變數來確保重要內容不會出現在顯示器之外。警告
透過將
user-scalable設定為no來停用縮放功能會阻止視力障礙者閱讀和理解頁面內容。
其他元資料名稱
WHATWG Wiki 元擴充套件頁面 包含大量尚未正式接受的非標準元資料名稱;但是,其中一些名稱在實踐中已經非常普遍地使用 - 包括以下內容
creator: 文件建立者的名稱,例如組織或機構。 如果有多個建立者,應使用多個<meta>元素。googlebot,是robots的同義詞,只被 Googlebot(Google 的索引爬蟲)使用。publisher: 文件釋出者的名稱。robots: 協作爬蟲或“機器人”應如何使用頁面的行為。 它是一個逗號分隔的值列表,如下所示值 描述 使用物件 index允許機器人索引頁面(預設值)。 所有 noindex請求機器人不要索引頁面。 所有 follow允許機器人跟隨頁面上的連結(預設值)。 所有 nofollow請求機器人不要跟隨頁面上的連結。 所有 all等效於 index, followGoogle none等效於 noindex, nofollowGoogle noarchive請求搜尋引擎不要快取頁面內容。 Google,Yahoo,Bing nosnippet阻止在搜尋引擎結果中顯示頁面描述。 Google,Bing noimageindex請求此頁面不要作為已索引影像的引用頁面出現。 Google nocache是 noarchive的同義詞。Bing 注意
- 只有協作機器人會遵循這些規則。 不要指望透過它們來阻止電子郵件收集器。
- 機器人仍然需要訪問頁面才能讀取這些規則。 為了防止頻寬消耗,請考慮是否使用robots.txt 檔案更合適。
robots<meta>標籤和robots.txt檔案用途不同:robots.txt控制頁面爬取,不會影響索引或robots元資料控制的其他行為。 如果頁面被其他文件引用,則即使無法爬取,它也可能仍然被索引。- 如果你想刪除頁面,
noindex會起作用,但只有在機器人再次訪問頁面之後才會起作用。 確保robots.txt檔案沒有阻止重新訪問。 - 一些值是互斥的,例如
index和noindex,或follow和nofollow。 在這些情況下,機器人的行為是未定義的,並且它們之間可能有所不同。 - 一些爬蟲機器人,如 Google、Yahoo 和 Bing,支援 HTTP 頭部
X-Robots-Tag的相同值;這允許非 HTML 文件(如影像)使用這些規則。
規範
| 規範 |
|---|
| HTML 標準 # standard-metadata-names |
| 引用者策略 # referrer-policy-delivery-meta |
瀏覽器相容性
BCD 表格僅在瀏覽器中載入