iframe の追加
Important: this documentation is not applicable to your currently selected format email!
ここでは、ページにインクルードメディアコンテンツを表示したり、iframe を使用して AMP の制限を受けずに高度なコンテンツを表示したりする方法について解説します。
基本
amp-iframe
要素を使用すると、ページに iframe を表示できます。
iframe は、メインページのコンテキストでサポートされていないコンテンツ(ユーザー作成の JavaScript を必要とするコンテンツなど)を AMP で表示する場合に特に便利です。
amp-iframe
の要件
- 最初のビューポートが上部から 600 ピクセル または 75% 以上離れていること。
- HTTPS 経由でのみリソースをリクエストできること(allow-same-origin を指定している場合を除き、リソースのオリジンはコンテナとは別である必要があります)。
amp-iframe
の仕様もご覧ください。 Include the script
ページに amp-iframe
を含めるには、 まず <head>
に以下のスクリプトを追加します。これにより、拡張コンポーネントの追加コードが読み込まれます。
<script async custom-element="amp-iframe" src="https://cdn.ampproject.org/v0/amp-iframe-0.1.js"></script>
Write the markup
以下の例では、レスポンシブ amp-iframe
を作成して、Google Maps Embed API を通じて Google マップを組み込んでいます。
<amp-iframe
width="200"
height="100"
sandbox="allow-scripts allow-same-origin"
layout="responsive"
src="https://www.google.com/maps/embed/v1/place?key={YOUR API KEY}&q=europe"
>
</amp-iframe>
プレースホルダの使用
placeholder
属性を指定した要素(amp-img
要素など)を amp-iframe
に追加して、iframe が表示できる状態になるまでプレースホルダとしてレンダリングされるようにすると、amp-iframe
をドキュメントの一番上に表示することが可能です。
プレースホルダを使用した例:
<amp-iframe
width="400"
height="225"
sandbox="allow-scripts allow-same-origin"
layout="responsive"
src="https://giphy.com/embed/OWabwoEn7ezug"
>
<amp-img
placeholder
layout="fill"
src="https://ampproject-b5f4c.firebaseapp.com/examples/images/kittens-biting.jpg"
></amp-img>
</amp-iframe>
次のようにレンダリングされます。
例
より高度な amp-iframe
の例については、AMP By Example をご覧ください。