Spec-Zone.ru › HTML

<portal>: Элемент портала

Экспериментально: Это экспериментальная технология
Перед использованием в производстве внимательно изучите таблицу совместимости с браузерами.

Элемент <portal> HTML позволяет встраивать другую страницу HTML в текущую для более плавного перехода на новые страницы.

Элемент <portal> аналогичен элементу <iframe>. Элемент <iframe> позволяет встраивать отдельный контекст просмотра. Однако содержимое встраиваемого элемента <portal> ограничено по сравнению с элементом <iframe>. С ним нельзя взаимодействовать, поэтому он не подходит для встраивания виджетов в документ. Вместо этого элемент <portal> действует как предварительный просмотр содержимого другой страницы. К нему можно перейти, обеспечивая бесшовный переход к встроенному содержимому.

Атрибуты

Этот элемент включает глобальные атрибуты.

referrerpolicy

Устанавливает политику отслеживания перехода при запросе страницы по адресу, указанному в значении атрибута src.

src

URL страницы для встраивания.

Удобство использования

Предварительный просмотр, отображаемый элементом <portal>, не интерактивен, поэтому не получает событий ввода или фокуса. Поэтому встроенное содержимое портала не отображается как элементы в дереве доступности. К порталу можно перейти и активировать его, как к кнопке; по умолчанию при нажатии на портал он активируется.

Порталам присваивается метка по умолчанию, которая является заголовком встраиваемой страницы. Если заголовок отсутствует, видимый текст в предварительном просмотре объединяется для создания метки. Атрибут aria-label может быть использован для переопределения этого значения.

Порталы, используемые только для предварительной обработки, должны быть скрыты с помощью атрибута hidden HTML или свойства CSS display со значением none.

При использовании анимации при активации портала необходимо учитывать prefers-reduced-motion медиа-параметр.

Примеры

Базовый пример

В следующем примере будет вставлено содержимое https://example.com в качестве предварительного просмотра.

html
<portal id="exampleportal" src="https://example.com/"></portal>

Техническое резюме

Неявная роль ARIA кнопка
Интерфейс DOM HTMLPortalElement

Спецификации

Спецификация
Порталы
# the-portal-element

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
portal 85 90 Нет 73 Нет 85 Нет Нет Нет Нет Нет

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTML/Element/portal

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API