amp-iframe

Показывает окно iframe.

Принципы работы

Компонент amp-iframe имеет ряд существенных отличий от окон iframe vanilla, которые обеспечивают высокую безопасность компонента и позволяют не использовать файлы AMP, основанных на одном окно iframe. Эти отличия перечислены ниже.

• Компонент amp-iframe не может появляться близко к верхней части документа (исключением являются окна iframe, в которых используется элемент placeholder в соответствии с описанием ниже). Такое окно iframe должно быть удалено от верха документа по меньшей мере на 600 пикселей или не находиться в первых 75 % площади области просмотра при прокрутке вверх.
• Компоненты amp-iframe по умолчанию проверяются в тестовой среде. Подробнее…
• Компонент amp-iframe может запрашивать ресурсы только по протоколу HTTPS, атрибута srcdoc, а также из URI данных.
• Компонент amp-iframe может относится к тому же источнику, что и контейнер, только если в атрибуте sandbox для них включен элемент allow-same-origin. Дополнительные сведения о разрешенных источниках окон iframe доступны в специальном документе.

Пример: встраивание Google Карт в компонент amp-iframe

<amp-iframe width="200" height="100"
    sandbox="allow-scripts allow-same-origin"
    layout="responsive"
    frameborder="0"
    src="https://www.google.com/maps/embed/v1/place?key=AIzaSyDG9YXIhKBhqclZizcSzJ0ROiE0qgVfwzI&q=iceland">
  </amp-iframe>

Как выполняется показ:

Использование компонента amp-iframe для показа рекламы

Основным назначением компонента amp-iframe не может быть показ рекламы. С помощью этого компонента можно`` показывать видеоролики, некоторых из которых имеют рекламный характер. Для соблюдения этого правила могут не обрабатываться соответствующие окна iframe.

В рекламных целях следует использовать компонент amp-ad.

Это правило действует по следующим причинам:

• Компонент amp-iframe предусматривает проверку в тестовой среде, а такая среда также применяется к дочерним окнам iframe. Это может привести к некорректному отображению целевых страниц, даже если объявление показывается нормально.
• Компонент amp-iframe не может передавать сведения о конфигурации окну iframe.
• Компонент amp-iframe не содержит средств изменения размера, полностью контролируемых окном iframe.
• Для компонента amp-iframe могут быть недоступны данные по видимости окон iframe.

Атрибуты

Окно iframe с тегом

Компонент amp-iframe можно настроить так, чтобы он появлялся в верхней части документа, если для этого компонента `добавлен элементplaceholder`, как показано в примере ниже.

• Компонент amp-iframe должен содержать элемент с атрибутом placeholder (например, элемент amp-img) который будет обрабатываться как тег, пока окно iframe не будет готово к показу.
• О готовности окна iframe к показу сигнализирует его элемент onload или элемент embed-ready postMessage, который отправляется из документа окна iframe.

Пример: окно iframe с тегом

<amp-iframe width=300 height=300
    layout="responsive"
    sandbox="allow-scripts allow-same-origin"
    src="https://foo.com/iframe">
    <amp-img layout="fill" src="https://foo.com/foo.png" placeholder></amp-img>
</amp-iframe>

Пример: запрос готовности встраивания окна iframe

window.parent.postMessage({
  sentinel: 'amp',
  type: 'embed-ready'
  }, '*');

Изменение размера окна iframe

Как для любого элемента AMP-страниц, для компонента amp-iframe необходимо определить статический макет. Однако для компонента amp-iframe можно изменить размер во время выполнения. Для этого должны быть соблюдены следующие условия:

1. Компонент amp-iframe должен быть определен с помощью атрибута resizable.
2. У компонента amp-iframe должен быть дочерний элемент overflow.
3. Компонент amp-iframe должен определять атрибут allow-same-origin для тестовой среды.
4. Запрос embed-size, который отправляется документом окна iframe, должен представлять собой сообщение в окне.
5. Высота запроса не должна быть меньше заданного порогового значения (100 пикселей). В противном случае запрос embed-size будет отклонен.

Учтите, что атрибут resizable устанавливает для элемента scrolling значение no.

Пример: компонент amp-iframe с элементом overflow

<amp-iframe width=300 height=300
    layout="responsive"
    sandbox="allow-scripts allow-same-origin"
    resizable
    src="https://foo.com/iframe">
    <div overflow tabindex=0 role=button aria-label="Read more">Read more!</div>
</amp-iframe>

Пример: запрос на изменение размера окна iframe

window.parent.postMessage({
  sentinel: 'amp',
  type: 'embed-size',
  height: document.body.scrollHeight
  }, '*');

После получения сообщения библиотека AMP стремится как можно быстрее выполнить запрос, но учитывает различные факторы, связанные с интерфейсом и эффективностью, например место чтения и использование прокрутки. Если удовлетворить запрос не удается, компонент amp-iframe обеспечит показ элемента overflow. Нажатие на элемент overflow приведет к изменению размера компонента amp-iframe, так как для этого необходимо действие пользователя.

Скорость изменения размеров может зависеть от того, связано ли оно:

• с действием пользователя;
• с запросом для активного окна iframe;
• с запросом для окна iframe, находящегося под или над областью просмотра.

Видимость окон iframe

Окна iframes могут отправлять родительским элементам сообщение send-intersections, чтобы получать данные об изменениях стиля IntersectionObserver для совпадения этих окон с областью просмотра родительских элементов.

Примечание. В приведенных ниже примерах считается, что скрипт содержится в созданном окне iframe, причем верхним окном является вариант window.parent. Если скрипт находится во вложенном окне iframe, вариант window.parent необходимо изменить на верхнее окно AMP-страницы.

Пример: запрос send-intersections в окне iframe

window.parent.postMessage({
  sentinel: 'amp',
  type: 'send-intersections'
  }, '*');

Окно iframe может получать данные о совпадении с областью просмотра родительских элементов из сообщения intersection, полученного от этих элементов.

Пример: запрос send-intersections в окне iframe

window.addEventListener('message', function(event) {
  if (event.source != window.parent ||
  event.origin == window.location.origin ||
  !event.data ||
  event.data.sentinel != 'amp' ||
  event.data.type != 'intersection') {
    return;
    }
  event.data.changes.forEach(function (change) {
    console.log(change);
  });
});

Сообщение intersection направляется от родительского элемента в окно iframe, если при прокрутке этого окна или изменении его размера оно входит в область просмотра или выходит из него либо является видимым частично.

Отслеживание и анализ эффективности окон iframe

Мы настоятельно рекомендуем в аналитических целях использовать компонент amp-analytics, так как он представляет собой комплексное и эффективное решение, которое можно настроить для самых разных поставщиков аналитических услуг.

На AMP-странице может быть только одно окно iframe, предназначенное для отслеживания и анализа. Для экономии ресурсов такие окна iframe удаляются из элемента DOM спустя 5 секунд после загрузки. Этого времени обычно достаточно для выполнения всех необходимых задач.

Предназначенными для отслеживания и анализа считаются окна iframe, которые не выполняют никакой функции, связанной непосредственно с пользователями, такой как обеспечение невидимости или малого размера.

Рекомендация: использование имеющихся компонентов AMP-страниц поверх компонента amp-iframe

Компонент amp-iframe считается резервным объявлением, если необходимого результата на AMP-странице нельзя добиться другими средствами или если на ней нет подходящего компонента AMP. Это связано с тем, что существует ряд преимуществ использования компонента AMP, предназначенного для конкретного случая, например:

• Благодаря удобному управлению ресурсами обеспечивается их высокая эффективность.
• В некоторых случаях благодаря специальным компонентам могут появиться встроенные изображения тегов. В частности, это может обеспечить подходящее уменьшенное изображение перед загрузкой видео или облегчить написание кода для добавления тега вручную.
• Предусмотрена возможность изменения размеров. Иными словами, если контент окна iframe не имеет определенного размера, он может чаще показываться на странице в качестве ее исходного контента, а фрейма с функцией прокрутки.
• Могут быть встроены другие дополнительные функции, такие как автовоспроизведение для проигрывателей.

Валидация

С правилами для компонента amp-iframe можно ознакомиться в спецификации валидатора AMP.