iframe

iframe встраивает HTML‑страницу или документ в текущую страницу.

XML-элемент

iframe

Java-класс

IFrame

Основы

Ниже показан пример базового использования iframe:

<iframe width="100%" height="100%" css="border: unset;"
        resource="https://en.wikipedia.org/wiki/Parrot"/>

Отображение документов

Укажите в resource путь приложения к статическому документу. В примере встраивается PDF-файл из ресурсов приложения:

<layout>
    <iframe width="100%" height="100%" css="border: unset;"
            resource="pdf/tutorial.pdf"/>
</layout>

В связанных примерах показаны динамически созданные документы и документы, загруженные через REST:

Встроенное HTML-содержимое

Если фрейм должен отображать содержимое непосредственно из дескриптора экрана, задайте в resourceDoc экранированную HTML-разметку:

<iframe resourceDoc="&lt;h1&gt;Awesome!&lt;h1/&gt;"/>

Атрибуты

Общие атрибуты выполняют ту же функцию для всех компонентов. Следующие атрибуты специфичны для iframe:

Имя Описание По умолчанию

allow

Задаёт политику разрешений для функций, доступных встроенному содержимому.

importance

Указывает браузеру приоритет ресурса при отображении страницы: AUTO, HIGH или LOW.

AUTO

name

Задаёт имя встроенного контекста просмотра, которое можно использовать как цель ссылки или формы.

resource

Путь к статическому ресурсу, например resource="pdf/tutorial.pdf" или URL.

resourceDoc

Задаёт экранированное встроенное HTML-содержимое. См. Встроенное HTML-содержимое.

sandbox

Ограничивает возможности встроенного содержимого. Укажите через запятую значения SandboxType, например RESTRICT_ALL или ALLOW_SCRIPTS. Если атрибут не задан, ограничения песочницы не применяются.

Обработчики

Имя Описание

AttachEvent

Срабатывает при присоединении фрейма к UI.

DetachEvent

Срабатывает при отсоединении фрейма от UI.