AMP
EN
Deutsch Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

AMP 驗證錯誤

有效的 AMP 文件不得包含任何驗證錯誤。本文檔的目的是協助您更瞭解並修正您在驗證您的 AMP 頁面時遇到的任何驗證錯誤。如需驗證錯誤的完整概述，請參閱 AMP 驗證器規格。

AMP HTML 標記和屬性錯誤

遺失必要標記

代碼 MANDATORY_TAG_MISSING
格式 「遺失或不正確的必要標記 '%1'。」
修正 新增 (或修正) 必要 HTML 標記。

以下標記必須存在於所有 AMP 電子郵件中

  • <!doctype html>
  • <html amp4email> 或 <html ⚡4email>
  • <head>
  • <meta charset="utf-8">
  • <style amp4email-boilerplate>body{visibility:hidden}</style>
  • <script async src="https://cdn.ampproject.org/v0.js"></script>
  • <body>

這些必要標記在 AMP 驗證器規格中包含 mandatory: true 欄位；它們也於 AMP 規格中被引用。

缺少另一個標記所需的標記

代碼 TAG_REQUIRED_BY_MISSING
格式 「遺失或不正確的 '%1' 標記，但 '%2' 要求此標記。」
修正 新增 (或修正) 必要的 HTML 標記。

當驗證器在 AMP 文件中找到擴充元件，但找不到其對應的 <script> 時，會擲回 TAG_REQUIRED_BY_MISSING 錯誤。

擴充元件必須以自訂元素的形式明確包含在 AMP 文件中。若要修正這些錯誤，請瀏覽至擴充元件的參考頁面、複製其必要的指令碼，並將其貼到 AMP 文件的 <head> 中。

不允許的標記

代碼 DISALLOWED_TAG
格式 「不允許標記 '%1'。」
修正 移除不允許的標記。

標記已加入允許清單，因此沒有所有不允許標記的明確清單；但是，AMP 規格廣泛定義了不允許標記的集合。

不允許自訂 JavaScript

代碼 DISALLOWED_SCRIPT_TAG
格式 「不允許自訂 JavaScript。」
修正 移除 javascript 標記或使用 amp-script。

AMP 格式不允許透過 <script> 元素將自訂 JavaScript 新增至頁面。JavaScript 的許多常見用途都有 AMP HTML 程式庫的對等實作。請參閱 AMP 元件，以瞭解可用於增強 AMP HTML 頁面的元件集。

如果沒有任何可用的元件涵蓋您的使用案例，則可以使用 amp-script 來執行您的自訂 JavaScript。

遺失必要屬性

代碼 MANDATORY_ATTR_MISSING
格式 「標記 '%2' 中遺失必要屬性 '%1'。」
修正 將必要屬性新增至標記。

AMP 標記的必要屬性定義於 AMP 的驗證器規格中。只需搜尋標記、檢視列出的屬性，並檢查 mandatory: true。每個 AMP 標記的必要屬性也列於標記的規格中。

屬性值無效

代碼 INVALID_ATTR_VALUE
格式 「標記 '%2' 中的屬性 '%1' 設定為無效值 '%3'。」
修正 將屬性值修正為有效的值。

此錯誤表示 HTML 標記具有允許名稱的屬性，但值不允許。例如，此錯誤的一個常見觸發因素是網址的無效值。所有網址值 (在 href 和 src 屬性中) 都必須符合這些可能的屬性值之一。

重要事項： AMP 中的許多網址值都需要 HTTPS。如果您收到此錯誤，但不確定原因，請檢查相關 AMP 標記的規格，以查看屬性是否需要 HTTPS。

不允許的屬性

代碼 DISALLOWED_ATTR
格式 「標記 '%2' 中不得出現屬性 '%1'。」
修正 從 HTML 標記中移除屬性。

屬性已加入允許清單，因此沒有所有不允許屬性的明確清單。若要檢查每個特定標記的支援屬性，請在 AMP 驗證器規格中搜尋 HTML 標記，然後搜尋 attrs。

除了每個標記的特定屬性允許清單之外，所有 AMP 標記都可以使用在 $GLOBAL_ATTRS 下允許清單中的任何屬性；所有具有 "data-" 前綴的屬性也都在允許清單中。

遺失或不正確的必要文字

代碼 MANDATORY_CDATA_MISSING_OR_INCORRECT
格式 「遺失或不正確的標記 '%1' 內必要文字 (CDATA)。」
修正 新增或修正標記內的必要文字。

CDATA 是 HTML 開始和結束標記之間的內容資料，目前使用允許清單和拒絕清單進行評估。具有必要 CDATA 的標記包括

<style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript>

和

<style amp-custom>

此錯誤的詳細訊息可能是下列其中之一

  • 「必要樣式範本 (已啟用 js)」
  • 「必要樣式範本 (noscript)」
  • 「不允許的 -amp- CSS 類別名稱前綴」
  • 「不允許 CSS 中的 !important 屬性」
  • 「不允許 CSS 中的 @charset」
  • 「不允許 CSS 中的 @import」
  • 「不允許 CSS 中的 @namespace」
  • 「不允許 CSS 中的 @supports」
  • 「不允許 CSS 中的 @document」

  • 「不允許 CSS 中的 @page」

    標記內不允許的文字

    代碼 CDATA_VIOLATES_DENYLIST
    格式 「標記 '%1' 內的文字 (CDATA) 符合 '%2'，這是被禁止的。」
    修正 移除不允許的文字。

    特定的 CSS 資料已被拒絕列入清單，以驗證基本的 CSS AMP 規則。

    以下是不允許的 CSS 資料清單 (另請參閱 AMP 驗證器規格中的 disallowed_cdata_regex)

    • "\\.i?-amp-" ("CSS -amp- 類別名稱前綴")
    • "!important"
    • "charset"
    • "&#64;import"
    • "@namespace"
    • "@document"

    • "@page"

      屬性值無效

      代碼 INVALID_PROPERTY_VALUE_IN_ATTR_VALUE
      格式 「標記 '%3' 中屬性 '%2' 的屬性 '%1' 設定為 '%4'，這是無效的。」
      修正 修正無效的屬性值。

      當屬性內的屬性值無效時，就會發生此錯誤。此處的屬性一詞是指屬性內的結構化鍵/值資料。

      遺失網址

      代碼 MISSING_URL
      格式 「標記 '%2' 中遺失屬性 '%1' 的網址。」
      修正 新增有效的網址。

      當需要網址的屬性遺失網址時，就會發生此錯誤，例如，空的 href 或 src 屬性。

      網址無效

      代碼 INVALID_URL_PROTOCOL
      格式 「標記 '%2' 中屬性 '%1' 的網址 '%3' 格式錯誤」
      修正 修正損壞的網址。

      當屬性具有網址，但網址無效時，就會發生此錯誤。

      網址協定無效

      代碼 INVALID_URL_PROTOCOL
      格式 標記 '%2' 中屬性 '%1' 的網址協定 '%3:' 無效。
      修正 變更為有效的協定，例如，http 可能需要是 https。

      當標記的 href 或 src 必須設定為特定協定時，就會發生此錯誤。例如，許多標記都需要 https。

      互斥屬性

      代碼 MUTUALLY_EXCLUSIVE_ATTRS
      格式 「標記 '%1' 中遇到互斥屬性 - 從 %2 中選擇一個。」
      修正 移除其中一個互斥屬性。

      當標記同時具有互斥屬性時，就會發生此錯誤。例如，下列標記僅允許一個

      從清單中遺失必要屬性

      代碼 MANDATORY_ONEOF_ATTR_MISSING
      格式 「標記 '%1' 遺失必要屬性 - 從 %2 中選擇一個。」
      修正 從提供的屬性選項中新增遺失的必要屬性。

      當標記從多個選項中遺失一個必要屬性時，就會發生此錯誤。例如，這些標記需要從兩個可能的選項中選擇一個屬性

      錯誤的父標記

      代碼 WRONG_PARENT_TAG
      格式 「標記 '%1' 的父標記是 '%2'，但它只能是 '%3'。」
      修正 使標記成為必要父項的直接子項。

      特定標記需要直接父項 (而不是遠祖)。以下列出特定標記的必要父項 (標記、父項)

      • !doctype 需要父標記 root。
      • html 需要父標記 !doctype。
      • head 需要父標記 html。
      • body 需要父標記 html。
      • link 需要父標記 head。
      • meta 需要父標記 head。
      • style amp-custom 需要父標記 head。
      • style 需要父標記 boilerplate (noscript)。
      • noscript 需要父標記 head。
      • script 需要父標記 head。
      • source 需要媒體標記 (amp-audio、amp-video 等)。

      不允許的標記祖先

      代碼 DISALLOWED_TAG_ANCESTOR
      格式 「標記 '%1' 不得作為標記 '%2' 的子系出現。」
      修正 移除 (或移動) 不允許的巢狀標記。

      當標記是不驗證的另一個標記的子系時，就會發生此錯誤。目前，唯一的範例是 template 標記，它不得巢狀在另一個 template 標記下。

      必要的標記祖先

      代碼 MANDATORY_TAG_ANCESTOR
      格式 「標記 '%1' 只能作為標記 '%2' 的子系出現。」
      修正 移除標記或使其成為特定標記的子系。

      必要子系在 AMP 驗證器規格中定義為 mandatory_ancestor。

      當下列標記遺失其 mandatory_ancestor 時，就會發生錯誤 (標記、祖先)

      • img 必須是 noscript 的子系。
      • video 必須是 noscript 的子系。
      • audio 必須是 noscript 的子系。
      • noscript 必須是 body 的子系。

      重複的唯一標記

      代碼 DUPLICATE_UNIQUE_TAG
      格式 「標記 '%1' 在文件中出現多次。」
      修正 從 AMP 文件中移除其中一個重複的標記。

      當只允許一個標記執行個體，但找到重複項時，就會發生此錯誤。

      已知唯一標記的完整清單

      • <!doctype html>
      • <html amp>
      • <head>
      • <link rel=canonical href=...>
      • <link rel=amphtml href=...>

      • <meta charset="utf-8"> * <style amp-custom> * <style amp-boilerplate>body{-webkit-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-moz-animation:-amp-start 8s steps(1,end) 0s 1 normal both;-ms-animation:-amp-start 8s steps(1,end) 0s 1 normal both;animation:-amp-start 8s steps(1,end) 0s 1 normal both}@-webkit-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-moz-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-ms-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@-o-keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}@keyframes -amp-start{from{visibility:hidden}to{visibility:visible}}</style><noscript><style amp-boilerplate>body{-webkit-animation:none;-moz-animation:none;-ms-animation:none;animation:none}</style></noscript> * <body> * <script src="https://cdn.ampproject.org/v0.js">

        樣式和版面配置錯誤

        在深入探討樣式和版面配置錯誤之前，值得瞭解 樣式設定和 版面配置控制在 AMP 中的運作方式。由於 AMP 頁面是 HTML 頁面，因此樣式設定與任何 HTML 頁面非常相似。但是，有一些限制可確保頁面快速載入，而 AMP 驗證器會強制執行這些限制。

        版面配置在 AMP 頁面中受到更多控制。頁面上顯示的任何標記都需要預先定義的高度和寬度，這可以顯著減少呈現和捲動延遲。這並不表示您必須手動包含這些屬性。對於某些版面配置類型，AMP 驗證器不會擲回錯誤，因為會假設預設值。

        每個 AMP 標記都有 supported_layouts 清單，如 AMP 驗證器規格中所定義。驗證器會針對不支援的版面配置擲回錯誤，並且會檢查預先定義版面配置的驗證規則。

        樣式表過長

        代碼 STYLESHEET_TOO_LONG
        格式 「標記 'style' 中指定的作者樣式表過長 - 我們看到 %1 個位元組，而限制為 %2 個位元組。」
        修正 縮減樣式表的大小，使其小於 75,000 個位元組。

        當 AMP 驗證器測量 <style amp-custom> 內樣式內容的大小超過 75,000 個位元組的限制時，會擲回此錯誤。

        CSS 語法錯誤

        代碼 CSS_SYNTAX
        格式 「標記 '%1' 中的 CSS 語法錯誤 - %2。」
        修正 修正 CSS 語法錯誤。

        當您在指定的標記中發生 CSS 語法錯誤時，就會發生此錯誤。如果您不確定導致錯誤的原因，請嘗試透過線上 CSS 驗證器 (例如，csslint) 執行 CSS。

        特定規則的 CSS 語法錯誤

        代碼 CSS_SYNTAX_INVALID_AT_RULE
        格式 「標記 '%1' 中的 CSS 語法錯誤 - 看到無效的 at 規則 '%2'。」
        修正 修正指定的 CSS 語法錯誤。

        此錯誤是指 CSS 內的 @-規則，AMP 僅允許少數規則。(另請參閱 AMP 規格)。例如，不允許 @import。驗證錯誤會明確告知您無效的規則，使其更容易修正該規則。

        AMP 標記不支援隱含版面配置

        代碼 IMPLIED_LAYOUT_INVALID
        格式 「標記 '%2' 不支援隱含版面配置 '%1'。」
        修正 為標記提供有效的版面配置屬性。

        當您未為 AMP 標記指定版面配置，且不支援隱含版面配置 (根據寬度、高度和尺寸) 時，就會發生此錯誤。請在 AMP 驗證器規格中檢查標記的 supported_layout 值。

        實際的版面配置行為由 layout 屬性決定。如需版面配置運作方式的詳細資訊，請參閱如何控制版面配置和 AMP HTML 版面配置系統規格。

        注意 – 如果您未指定版面配置，且未包含 width 和 height 值，則版面配置預設為 CONTAINER。由於任何 AMP 標記都不支援 CONTAINER，因此驗證器會擲回錯誤。請指定 CONTAINER 以外的版面配置，或新增 width 和/或 height 值，錯誤就會消失。

        隱含版面配置不允許的屬性

        代碼 ATTR_DISALLOWED_BY_IMPLIED_LAYOUT
        格式 「標記 '%2' 中的屬性 '%1' 不允許隱含版面配置 '%3'。」
        修正 從標記中移除不允許的屬性，或指定允許它的版面配置。

        當您未為 AMP 標記指定版面配置，且隱含版面配置包含不允許的屬性時，就會發生此錯誤。版面配置類型的不允許屬性在 AMP HTML 版面配置系統規格中說明。

        AMP 標記不支援指定的版面配置

        代碼 SPECIFIED_LAYOUT_INVALID
        格式 「標記 '%2' 不支援指定的版面配置 '%1'。」
        修正 指定標記支援的版面配置。

        當標記指定的版面配置不受支援時，就會發生此錯誤。請在 AMP 驗證器規格中檢查標記的 supported_layout 值。

        實際的版面配置行為由 layout 屬性決定。如需版面配置運作方式的詳細資訊，請參閱如何控制版面配置和 AMP HTML 版面配置系統規格。

        指定的版面配置不允許的屬性

        代碼 ATTR_DISALLOWED_BY_SPECIFIED_LAYOUT
        格式 「標記 '%2' 中的屬性 '%1' 不允許隱含版面配置 '%3'。」
        修正 從標記中移除不允許的屬性，或指定允許它的版面配置。

        當您為 AMP 標記指定版面配置，且版面配置包含不允許的屬性時，就會發生此錯誤。版面配置類型的不允許屬性在 AMP HTML 版面配置系統規格中說明。

        版面配置所需屬性的值無效

        代碼 ATTR_VALUE_REQUIRED_BY_LAYOUT
        格式 「標記 '%3' 中屬性 '%2' 的值 '%1' 無效 - 對於版面配置 '%4'，將屬性 '%2' 設定為值 '%5'。」
        修正 將屬性設定為指定的值。

        當屬性值對於指定的版面配置無效時，就會發生此錯誤。若要瞭解是什麼觸發此錯誤，您需要熟悉版面配置的不同行為。

        假設您將版面配置設定為 fixed-height，並且您包含 height 和 width 的數值。fixed-height 版面配置採用 height 值。width 屬性不得存在，否則必須設定為 auto。驗證器會擲回 ATTR_VALUE_REQUIRED_BY_LAYOUT。

        寬度和高度的單位不一致

        代碼 INCONSISTENT_UNITS_FOR_WIDTH_AND_HEIGHT
        格式 「標記 '%1' 中寬度和高度的單位不一致 - 寬度以 '%2' 指定，而高度以 '%3' 指定。」
        修正 提供一致的單位寬度和高度。

        除了 layout=fixed 之外，寬度和高度屬性需要以相同的單位表示。當它們不相同時，就會觸發此錯誤。

        例如，<amp-img src="" layout="responsive" width="42px" height="42rem"> 會產生此錯誤訊息

        「標記 'amp-img' 中寬度和高度的單位不一致 - 寬度以 'px' 指定，而高度以 'rem' 指定。」

        範本錯誤

        除非範本語法在專門設計用於包含範本的 AMP 標記內，否則 AMP 頁面無法包含範本語法，例如，amp-mustache。

        在您的來源檔案中包含範本是可以的，只要這些檔案產生的輸出不包含範本即可 (另請參閱 使用 CSS 預處理器)。

        屬性包含範本語法

        代碼 TEMPLATE_IN_ATTR_NAME
        格式 「標記 '%2' 中屬性名稱 '%1' 中的 Mustache 範本語法。」
        修正 從屬性中移除 Mustache 範本語法。

        每當驗證器在屬性值中找到 Mustache 範本語法時，就會發生此錯誤。

        屬性包含未逸出的範本語法

        代碼 UNESCAPED_TEMPLATE_IN_ATTR_VALUE
        格式 「標記 '%2' 中的屬性 '%1' 設定為 '%3'，其中包含未逸出的 Mustache 範本語法。」
        修正 逸出 mustache 範本。

        每當驗證器在屬性值中找到 未逸出的 Mustache 範本語法時，就會發生此錯誤。

        屬性包含範本局部

        代碼 TEMPLATE_PARTIAL_IN_ATTR_VALUE
        格式 「標記 '%2' 中的屬性 '%1' 設定為 '%3'，其中包含 Mustache 範本局部。」
        修正 移除 mustache 局部。

        每當驗證器在屬性值中找到 Mustache 局部時，就會發生此錯誤。

        棄用錯誤

        已棄用的標記

        代碼 DEPRECATED_TAG
        格式 尚未定義錯誤訊息 (沒有已棄用的標記)。
        修正 移除已棄用的標記。

        當在 AMP 文件中找到先前有效的 AMP 標記時，就會發生此警告。這只是一個警告；包含警告的 AMP 文件仍然有效。目前不存在已棄用的標記；警告保留供未來棄用使用。

        已棄用的屬性

        代碼 DEPRECATED_ATTR
        格式 「標記 '%2' 中的屬性 '%1' 已棄用 - 請改用 '%3'。」
        修正 作為最佳實務，移除已棄用的屬性。

        當在 AMP 文件中找到先前有效的 AMP 屬性時，就會發生此警告。這只是一個警告；包含警告的 AMP 文件仍然有效。

        透過在 AMP 驗證器規格中搜尋 deprecation，來識別每個 AMP 標記的已棄用屬性。