| WebReference
Элемент <iframe> (от англ. inline frame — встроенный фрейм) создаёт встроенный фрейм, который находится внутри обычного документа, он позволяет загружать в область заданных размеров любые другие независимые документы.
<iframe> является контейнером, содержание которого игнорируется браузерами, не поддерживающими данный элемент. Для таких браузеров можно указать альтернативный текст, который увидят пользователи. Он должен располагаться между тегами <iframe> и </iframe>.
Синтаксис
<iframe>...</iframe>
Атрибуты
- align
- Определяет, как фрейм будет выравниваться по краю, а также способ обтекания его текстом.
- allowfullscreen
- Разрешает для фрейма полноэкранный режим.
- frameborder
- Устанавливает, отображать границу вокруг фрейма или нет.
- height
- Высота фрейма.
- hspace
- Горизонтальный отступ от фрейма до окружающего контента.
- marginheight
- Отступ сверху и снизу от содержания до границы фрейма.
- marginwidth
- Отступ слева и справа от содержимого до границы фрейма.
- name
- Имя фрейма.
- sandbox
- Позволяет задать ряд ограничений на контент загружаемый во фрейме.
- scrolling
- Способ отображения полосы прокрутки во фрейме.
- seamless
- Определяет, что содержимое фрейма должно отображаться так, словно оно является частью документа.
- src
- Путь к файлу, содержимое которого будет загружаться во фрейм.
- srcdoc
- Хранит содержимое фрейма непосредственно в атрибуте.
- vspace
- Вертикальный отступ от фрейма до окружающего контента.
- width
- Ширина фрейма.
Пример
<!DOCTYPE HTML> <html> <head> <meta charset=»utf-8″> <title>IFRAME</title> </head> <body> <iframe src=»page/banner. html» align=»left»> Ваш браузер не поддерживает встроенные фреймы! </iframe> </body> </html> Спецификация
Спецификация | Статус |
---|---|
WHATWG HTML Living Standard | Живой стандарт |
HTML5 | Рекомендация |
HTML 4.01 Specification | Рекомендация |
Каждая спецификация проходит несколько стадий одобрения.
- Recommendation (Рекомендация) — спецификация одобрена W3C и рекомендована как стандарт.
- Candidate Recommendation (Возможная рекомендация) — группа, отвечающая за стандарт, удовлетворена, как он соответствует своим целям, но требуется помощь сообщества разработчиков по реализации стандарта.
- Proposed Recommendation (Предлагаемая рекомендация) — на этом этапе документ представлен на рассмотрение Консультативного совета W3C для окончательного утверждения.
- Working Draft (Рабочий проект) — более зрелая версия черновика после обсуждения и внесения поправок для рассмотрения сообществом.
- Editor’s draft (Редакторский черновик) — черновая версия стандарта после внесения правок редакторами проекта.
- Draft (Черновик спецификации) — первая черновая версия стандарта.
Браузеры
4 | 12 | 1 | 4 | 1 | 1 |
1 | 1 | 6 | 1 |
В таблице браузеров применяются следующие обозначения.
- — элемент полностью поддерживается браузером;
- — элемент браузером не воспринимается и игнорируется;
- — при работе возможно появление различных ошибок, либо элемент поддерживается с оговорками.
Число указывает версию браузреа, начиная с которой элемент поддерживается.
Фреймы
См. также
- Адаптивное встраивание
- Добавление медиа-контента
- Отзывчивый веб-дизайн
Практика
- Вставка JSFiddle
- Имя фрейма
- Картинка во фрейме
- Размеры фрейма
- Создание фрейма
- Ссылка во фрейм
- Ссылки во фрейме
Элементы HTML
Атрибуты
Значения
Типы элементов
Аудио и видео
Документ
Изображения
Объекты
Списки
Ссылки
Таблицы
Текст
Формы
Фреймы
Тег iframe
HTML5CSS. ru
ЛУЧШИЙ САЙТ ДЛЯ РАЗРАБОТЧИКОВ
❮Назад Полный HTML Ссылки Дальше ❯
Пример
Встроенный фрейм помечен следующим образом:
<iframe src=»https://html5css.ru»></iframe>
Пример
Встроенный фрейм помечен следующим образом:
<!DOCTYPE HTML>
<html>
<head>
<title>Тег IFRAME</title>
<body>
<iframe src=»frame_b.htm»>
Ваш браузер не поддерживает плавающие фреймы!
</iframe>
</body>
</html>
Пример
Пример содержания файла frame_b.htm
<html>
<head>
</head>
<body>
<h4>Frame B</h4>
</body>
</html>
Определение и использование
Тег <iframe> определяет встроенный фрейм.
Встроенный фрейм используется для встраивания другого документа в текущий документ HTML.
Поддержка браузера
Элемент | |||||
---|---|---|---|---|---|
<iframe> | Да | Да | Да | Да | Да |
Советы и примечания
Совет: Чтобы иметь дело с обозревателями, не поддерживающими <iframe>, добавьте текст между открывающим тегом <iframe> и закрывающим тегом </iframe>.
Совет: Используйте CSS для стиля <iframe> (даже для включения полосы прокрутки).
Различия между HTML 4,01 и HTML5
HTML5 добавил некоторые новые атрибуты, и несколько атрибутов HTML 4,01 удалены из HTML5.
Различия между HTML и XHTML
Атрибуты
= Новый в HTML5.
Атрибут | Значение | Описание |
---|---|---|
align | left right top middle bottom | Не поддерживается в HTML5. Задает выравнивание <iframe> в соответствии с окружающими элементами |
frameborder | 1 0 | Не поддерживается в HTML5. Указывает, отображать ли рамку вокруг <iframe> |
height | pixels | Задает высоту <iframe> |
longdesc | URL | Не поддерживается в HTML5. Задает страницу, содержащую подробное описание содержимого <iframe> |
marginheight | pixels | Не поддерживается в HTML5. Задает верхние и нижние поля содержимого <iframe> |
marginwidth | pixels | Не поддерживается в HTML5. Задает левое и правое поля содержимого <iframe> |
name | text | Задает имя <iframe> |
sandbox | allow-forms allow-pointer-lock allow-popups allow-scripts allow-top-navigation | Включает дополнительный набор ограничений для содержимого в <iframe> |
scrolling | yes no auto | Не поддерживается в HTML5. Указывает, отображать ли полосы прокрутки в <iframe> |
src | URL | Задает адрес документа для встраивания в <iframe> |
srcdoc | HTML_code | Задает HTML-содержимое страницы, которое должно отображаться в <iframe> |
width | pixels | Задает ширину <iframe> |
Глобальные атрибуты
Тег <iframe> также поддерживает Глобальные атрибуты в HTML.
Атрибуты события
Тег <iframe> также поддерживает Атрибуты событий в HTML.
Похожие страницы
HTML Учебник: HTML Iframes
HTML DOM Ссылки: IFrame Object
Параметры CSS по умолчанию
В большинстве обозревателей элемент <iframe> будет отображаться со следующими значениями по умолчанию:
iframe:focus {
outline: none;
}
iframe[seamless] {
display: block;
}
❮Назад Полный HTML Ссылки Дальше ❯
Популярное
html картинка
как вставить картинку в html
цвет текста фона
размер текста html
цвет размер шрифта html
формы html
список html
таблица html
как сделать ссылку в html
html элементы
Copyright 2018-2020 HTML5CSS.
Правила и Условия Политика конфиденциальности О нас Контакты
: Элемент Inline Frame — HTML: Язык гипертекстовой разметки
HTML-элемент
представляет вложенный контекст просмотра, встраивая другую HTML-страницу в текущую.
Каждый встроенный контекст просмотра имеет собственную историю сеансов и документ. Контекст просмотра, в который встроены другие, называется родительским контекстом просмотра . самый верхний контекст просмотра — тот, у которого нет родителя — обычно является окном браузера, представленным цифрой 9.0004 Окно объект.
Предупреждение: Поскольку каждый контекст просмотра представляет собой полную среду документа, каждый
на странице требует увеличения объема памяти и других вычислительных ресурсов. Хотя теоретически вы можете использовать столько
, сколько хотите, проверьте наличие проблем с производительностью.
Этот элемент включает глобальные атрибуты.
-
разрешить
Указывает политику разрешений для
Примечание: Политика разрешений, указанная атрибутом
allow
, реализует дополнительное ограничение поверх политики, указанной в заголовкеPermissions-Policy
. Это не заменяет его.-
разрешить полный экран
Установите значение
true
, еслиrequestFullscreen()
.Примечание: Этот атрибут считается устаревшим атрибутом и переопределен как
allow="fullscreen"
.-
разрешитьплатежныйзапрос
Expect behavior to change in the future.»> Экспериментальный Установите значение
true
, если используется кросс-источникПримечание: Этот атрибут считается устаревшим атрибутом и переопределен как
allow="payment"
.-
без учетных данных
Экспериментальный Нестандартный Установите значение
true
, чтобы сделатьПравила встраивания Cross-Origin-Embedder-Policy
(COEP) могут быть отменены, поэтому документы с установленным COEP могут встраивать сторонние документы, которые этого не делают. Дополнительные сведения см. в разделе IFrame без учетных данных.-
КСП
Экспериментальный Для встроенного ресурса применяется политика безопасности содержимого. Дополнительные сведения см. в статье
HTMLIFrameElement.csp
.-
высота
Высота кадра в пикселях CSS. По умолчанию
150
.-
загрузка
Экспериментальный Указывает, как браузер должен загружать iframe:
-
нетерпеливый
: немедленно загрузить iframe, независимо от того, находится ли он за пределами видимого окна просмотра (это значение по умолчанию). -
ленивый
: отложить загрузку iframe до тех пор, пока он не достигнет расчетного расстояния от области просмотра, как определено браузером.
-
-
имя
Целевое имя встроенного контекста просмотра. Это можно использовать в атрибуте
target
элементовили
; атрибутformtarget
элементовwindowName
в методеwindow.open()
.-
реферальная политика
Указывает, какой реферер отправлять при получении ресурса фрейма:
-
no-referrer
: ЗаголовокReferer
не будет отправлен. -
no-referrer-when-downgrade
: заголовокReferer
не будет отправлен источникам без TLS (HTTPS). -
origin
: Отправленный реферер будет ограничен источником ссылающейся страницы: ее схемой, хостом и портом. -
origin-when-cross-origin
: Реферер, отправляемый другим источникам, будет ограничен схемой, хостом и портом. Навигации в одном и том же источнике по-прежнему будут включать путь. -
тот же источник
: Реферер будет отправлен для того же источника, но запросы между источниками не будут содержать информацию о реферере. -
strict-origin
: отправляйте источник документа в качестве реферера, только если уровень безопасности протокола остается прежним (HTTPS→HTTPS), но не отправляйте его в менее безопасный пункт назначения (HTTPS→HTTP). -
strict-origin-when-cross-origin
(по умолчанию): отправлять полный URL-адрес при выполнении запроса того же источника, отправлять источник только при неизменном уровне безопасности протокола (HTTPS→HTTPS) и не отправлять заголовок в менее безопасное место назначения (HTTPS→HTTP). -
unsafe-url
: реферер будет включать в себя источник и путь (но не фрагмент, пароль или имя пользователя). Это значение небезопасно , поскольку оно приводит к утечке источников и путей от ресурсов, защищенных TLS, к небезопасным источникам.
-
-
песочница
Накладывает дополнительные ограничения на содержимое фрейма. Значение атрибута может быть либо пустым, чтобы применить все ограничения, либо разделенными пробелами токенами, чтобы снять определенные ограничения:
-
allow-downloads
: Позволяет загружать файлы через элемент -
разрешить загрузку без активации пользователем
Expect behavior to change in the future.»> Экспериментальный : Разрешает загрузку без жеста пользователя. -
allow-forms
: Разрешает странице отправлять формы. Если это ключевое слово не используется, форма будет отображаться как обычно, но ее отправка не приведет к проверке ввода, отправке данных на веб-сервер или закрытию диалогового окна. -
allow-modals
: Позволяет странице открывать модальные окна наWindow.alert()
,Window.confirm()
,Window.print()
иWindow.prompt()
, при этом открытие<диалога>
разрешено независимо от этого ключевого слова. Это также позволяет странице получать событиеBeforeUnloadEvent
. -
allow-orientation-lock
: Позволяет ресурсу заблокировать ориентацию экрана. -
allow-pointer-lock
: позволяет странице использовать API блокировки указателя. -
allow-popups
: Разрешить всплывающие окна (например, изWindow.open()
,target="_blank"
,Window.showModalDialog()
). Если это ключевое слово не используется, эта функциональность автоматически завершится ошибкой. -
allow-popups-to-escape-sandbox
: Позволяет документу в песочнице открывать новые окна, не навязывая им флаги песочницы. Это позволит, например, безопасно изолировать стороннюю рекламу, не применяя те же ограничения к странице, на которую ссылается реклама. -
allow-presentation
: Позволяет интеграторам контролировать, может ли iframe запускать сеанс презентации. -
allow-same-origin
: если этот токен не используется, ресурс рассматривается как имеющий особое происхождение, которое всегда не соответствует политике одного и того же происхождения (потенциально блокируя доступ к хранилищу данных/файлам cookie и некоторым API-интерфейсам JavaScript). -
allow-scripts
: Разрешает странице запускать сценарии (но не создавать всплывающие окна). Если это ключевое слово не используется, эта операция не разрешена. -
разрешить доступ к хранилищу при активации пользователем
Экспериментальный : позволяет ресурсу запрашивать доступ к возможностям родительского хранилища с помощью API доступа к хранилищу. -
allow-top-navigation
: Позволяет ресурсу перемещаться по контексту просмотра верхнего уровня (тому, что называется_top
). -
allow-top-navigation-by-user-activation
: Позволяет ресурсу перемещаться по контексту просмотра верхнего уровня, но только если он инициирован жестом пользователя. -
allow-top-navigation-to-custom-protocols
: Разрешает навигацию по протоколам, отличным отhttp
, встроенным в браузер или зарегистрированным веб-сайтом. Эта функция также активируется ключевым словомallow-popups
илиallow-top-navigation
.
Примечание:
- Если встроенный документ имеет то же происхождение, что и страница встраивания, настоятельно не рекомендуется использовать оба разрешающих сценария
allow-same-origin
, так как это позволяет встроенному документу удалить атрибут песочницы, что делает его не более безопасным, чем вообще не использовать атрибут
песочницы.
- Песочница бесполезна, если злоумышленник может отображать содержимое за пределами изолированного
iframe
— например, если зритель открывает фрейм в новой вкладке. Такой контент также должен обслуживаться из отдельного источника , чтобы ограничить возможный ущерб.
-
-
источник
URL-адрес страницы для встраивания. Используйте значение
about:blank
, чтобы внедрить пустую страницу, соответствующую политике того же источника. Также обратите внимание, что программное удаление атрибута srcElement.removeAttribute()
) приводит к загрузкеabout:blank
во фрейме в Firefox (начиная с версии 65), браузерах на основе Chromium. и Safari/iOS.-
исходный документ
Встроенный HTML-код для встраивания, переопределяющий атрибут
src
. Если браузер не поддерживает атрибутsrcdoc
, он вернется к URL-адресу в атрибутеsrc
.-
ширина
Ширина рамки в пикселях CSS. По умолчанию
300
.
Устаревшие атрибуты
Эти атрибуты устарели и могут больше не поддерживаться всеми пользовательскими агентами. Вы не должны использовать их в новом контенте и пытаться удалить их из существующего контента.
-
выравнивание
Устаревший Выравнивание этого элемента по отношению к окружающему контексту.
-
рамка
Устаревший Значение
1
(по умолчанию) рисует рамку вокруг этого кадра. Значение0
удаляет границу вокруг этого фрейма, но вместо этого вы должны использовать свойство CSSborder
для управления-
длинное описание
Устаревший URL-адрес длинного описания содержимого фрейма. Из-за широко распространенного неправильного использования это бесполезно для невизуальных браузеров.
-
высота поля
"> Устаревший Расстояние в пикселях между содержимым фрейма и его верхней и нижней границами.
-
ширина поля
Устаревший Расстояние в пикселях между содержимым фрейма и его левой и правой границами.
-
прокрутка
Устаревший Указывает, когда браузер должен предоставить полосу прокрутки для фрейма:
-
авто
: Только когда содержимое фрейма превышает его размеры. -
да
: Всегда показывать полосу прокрутки. -
№
: Никогда не показывать полосу прокрутки.
-
Встроенные фреймы, такие как элементы
, включены в псевдомассив window.frames
.
С помощью объекта DOM HTMLIFrameElement
сценарии могут получить доступ к объекту window
фреймового ресурса через свойство contentWindow
. Свойство contentDocument
ссылается на документ
внутри
, так же, как contentWindow.document
.
Изнутри фрейма скрипт может получить ссылку на свое родительское окно с помощью window.parent
.
Доступ сценария к содержимому фрейма регулируется политикой того же источника. Сценарии не могут получить доступ к большинству свойств в других объектах окна
, если сценарий был загружен из другого источника, включая сценарии внутри фрейма, обращающиеся к родителю фрейма. Связь между источниками может быть достигнута с помощью Window.postMessage()
.
В качестве замененного элемента положение, выравнивание и масштабирование встроенного документа в пределах блока элемента
можно настроить с помощью свойств object-position
и object-fit
.