AMP

amp-story-page-outlink

說明

在 AMP Story 頁面中,用於一鍵開啟外部連結的 CTA 按鈕。

 

必要指令碼

<script async custom-element="amp-story" src="https://cdn.ampproject.org/v0/amp-story-1.0.js"></script>

支援版面配置

用法

amp-story-page-outlink 提供一鍵跳出連結體驗的 UI。使用者可以透過「向上滑動」手勢或點擊呼籲行動元素來開啟跳出連結。UI 按鈕會出現在每個具有 amp-story-page-outlink 元素的頁面底部,提示瀏覽者開啟附件。它必須具有 layout="nodisplay" 屬性。

amp-story-page-outlink 需要單一 a 元素子項。


<amp-story-page id="page-outlink-example">
  <amp-story-grid-layer template="fill">
    <amp-img src="https://example.ampproject.org/helloworld/bg1.jpg" width="900" height="1600">
  </amp-story-grid-layer>
  <amp-story-page-outlink layout="nodisplay">
    <a href="https://www.google.com" title="Link Description"></a>
  </amp-story-page-outlink>
</amp-story-page>

放置

<amp-story-page-outlink> 元素必須是 <amp-story-page> 的最後一個子項,且必須具有 layout="nodisplay" 屬性。

amp-story-page-outlinkamp-story-page-attachment 都必須是 amp-story-page 的最後一個子標籤。因此,您可以選擇都不包含或只包含其中一個,但不能同時包含兩者。

自訂文字 (選填)

子錨點元素內的文字會顯示在 CTA 中。預設值為「向上滑動」。

amp-story-page-outlink-cta-text

<amp-story-page-outlink layout="nodisplay">
    <a href="https://www.google.com">Call To Action</a>
</amp-story-page-outlink>

屬性

當未設定任何屬性時,將會呈現預設 UI

amp-story-page-outlink-default

<amp-story-page-outlink layout="nodisplay">
    <a href="https://www.google.com"></a>
</amp-story-page-outlink>
<amp-story-page-outlink
  layout="nodisplay"
  cta-text="Read More">
  ...
</amp-story-page-outlink>

theme (選填)

代表色彩主題的字串,預設為 light。接受值 lightdarkcustom

theme="custom" 需要兩個額外屬性

  • `cta-accent-color`: 代表自訂主題色彩的字串。
  • `cta-accent-element`: 代表要套用自訂主題的元素的字串。接受值 `text` 和 `background`。

會自動套用對比保護,以確保可讀性和 a11y 相容性。例如,當強調元素為「background」時,會將較高對比的色彩 (黑色或白色) 套用至文字。

amp-story-page-outlink-dark-theme

<amp-story-page-outlink
  layout="nodisplay"
  theme="dark">
    <a href="https://www.google.com"></a>
</amp-story-page-outlink>

amp-story-page-outlink-custom-theme

<amp-story-page-outlink
  layout="nodisplay"
  theme="custom"
  cta-accent-element="background"
  cta-accent-color="#0047FF">
    <a href="https://www.google.com">Call To Action</a>
</amp-story-page-outlink>

amp-story-page-outlink-custom-theme

<amp-story-page-outlink
  layout="nodisplay"
  theme="custom"
  cta-accent-element="text"
  cta-accent-color="#247C3C">
    <a href="https://www.google.com">Call To Action</a>
</amp-story-page-outlink>

cta-image (選填)

代表指向圖片網址的字串。為了最佳化效能並避免失真,請使用 32x32 像素的圖片。預設會顯示連結圖示。

amp-story-page-outlink-cta-image

<amp-story-page-outlink
  layout="nodisplay"
  cta-image="/static/images/32x32icon.jpg">
    <a href="https://www.google.com">Call To Action</a>
</amp-story-page-outlink>

指定 cta-image=none 將會移除預設的連結圖示。

amp-story-page-outlink-cta-image-none

<amp-story-page-outlink
  layout="nodisplay"
  cta-image="none">
    <a href="https://www.google.com">Call To Action</a>
</amp-story-page-outlink>

amp-story-page-outlink 的功能過去是由 amp-story-page-attachment 支援。請使用 amp-story-page-outlink 來取得一鍵跳出連結 UI。

需要更多協助嗎?

您已閱讀這份文件十幾次,但它似乎仍未涵蓋您的所有問題?也許其他人也有相同的感受:請在 Stack Overflow 上與他們聯繫。

前往 Stack Overflow
發現錯誤或缺少功能?

AMP 專案大力鼓勵您的參與和貢獻!我們希望您能成為我們開放原始碼社群的長期參與者,但我們也歡迎您針對特別關注的問題提供一次性貢獻。

前往 GitHub