HTMLIFrameElement

Базовая Широко доступна *

Данная функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с июля 2015 года.

* Некоторые части этой функции могут иметь различный уровень поддержки.

Интерфейс HTMLIFrameElement предоставляет специальные свойства и методы (помимо тех, которые доступны через интерфейс HTMLElement по наследованию) для управления макетом и представлением элементов фрейма.

Свойства экземпляра

Наследует свойства от родительского класса, HTMLElement.

HTMLIFrameElement.align Устаревший: Строка, определяющая выравнивание фрейма относительно окружающего контекста.
HTMLIFrameElement.allow: Строка, указывающая политику разрешений Permissions Policy, заданную для этого <iframe>.
HTMLIFrameElement.allowFullscreen: Логическое значение, указывающее, может ли встроенный фрейм перейти в полноэкранный режим. Подробности см. в разделе Использование полноэкранного режима.
HTMLIFrameElement.allowPaymentRequest Устаревший Нестандартный: Логическое значение, указывающее, может ли быть вызван API Payment Request API внутри фрейма с другим происхождением.
HTMLIFrameElement.browsingTopics Экспериментальный Нестандартный: Свойство boolean, указывающее, что выбранные темы для текущего пользователя должны отправляться вместе с запросом на источник связанного <iframe>. Это отражает значение атрибута browsingtopics content.
HTMLIFrameElement.contentDocument Только для чтения: Возвращает объект Document, активный документ во вложенном контексте просмотра встроенного фрейма.
HTMLIFrameElement.contentWindow Только для чтения: Возвращает WindowProxy, прокси-объект окна для вложенного контекста просмотра.
HTMLIFrameElement.credentialless Экспериментальный: Логическое значение, указывающее, является ли <iframe> без аутентификационных данных (credentialless), что означает, что его содержимое загружается в новом, временном контексте. Этот контекст не имеет доступа к общим хранилищам и учётным данным родительского контекста. Взамен, правила встраивания Cross-Origin-Embedder-Policy (COEP) могут быть сняты, поэтому документы с COEP могут встраивать сторонние документы, которые этого не делают. Подробности см. в IFrame без учётных данных.
HTMLIFrameElement.csp Экспериментальный: Задает политику Content Security Policy, которую должен применить встроенный документ.
HTMLIFrameElement.featurePolicy Только для чтения Экспериментальный: Возвращает интерфейс FeaturePolicy, который предоставляет простой API для инспектирования применённых политик разрешений для конкретного документа.
HTMLIFrameElement.frameBorder Устаревший: Строка, указывающая, нужно ли создавать границы между фреймами.
HTMLIFrameElement.height: Строка, отражающая атрибут HTML height, указывающая высоту фрейма.
HTMLIFrameElement.loading: Строка, предоставляющая подсказку браузеру о том, что фрейм должен загружаться немедленно (eager) или по мере необходимости (lazy). Это отражает атрибут HTML loading.
HTMLIFrameElement.longDesc Устаревший: Строка, содержащая URI длинного описания фрейма.
HTMLIFrameElement.marginHeight Устаревший: Строка, представляющая высоту отступа фрейма.
HTMLIFrameElement.marginWidth Устаревший: Строка, представляющая ширину отступа фрейма.
HTMLIFrameElement.name: Строка, отражающая атрибут HTML name, содержащая имя для ссылки на фрейм.
HTMLIFrameElement.referrerPolicy: Строка, отражающая атрибут HTML referrerPolicy, указывающая, какой отправитель использовать при получении связанного ресурса.
HTMLIFrameElement.sandbox Только для чтения: Возвращает DOMTokenList, отражающий атрибут HTML sandbox, указывающий дополнительные ограничения на поведение вложенного содержимого.
HTMLIFrameElement.scrolling Устаревший: Строка, указывающая, должны ли браузер отображать полосы прокрутки для фрейма.
HTMLIFrameElement.src: Строка, отражающая атрибут HTML src, содержащая адрес встраиваемого содержимого. Обратите внимание, что программное удаление атрибута src у <iframe> (например, с помощью Element.removeAttribute()) приводит к загрузке about:blank в фрейме в Firefox (с версии 65), браузерах на основе Chromium и Safari/iOS.
HTMLIFrameElement.srcdoc: Строка, представляющая содержимое, которое должно отображаться в фрейме.
HTMLIFrameElement.width: Строка, отражающая атрибут HTML width, указывающая ширину фрейма.

Методы экземпляра

Также наследует методы от родительского интерфейса, HTMLElement.

HTMLIframeElement.getSVGDocument(): Возвращает встроенный SVG как Document.

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

Спецификация
HTML # htmliframeelement

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

	Настольный					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`HTMLIFrameElement`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	≤37
`adAuctionHeaders`	122	122	No	108	No	122	No	81	No	26.0	122
`align`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`allow`	60	79	74	47	11.1	60	79	44	11.3	8.0	60
`allowFullscreen`	38	12	229–18	25	10.1	38	229–18	25	12 ["Only available on iPad, not on iPhone.", "Shows an overlay button which can not be disabled. Swiping down exits fullscreen mode, making it unsuitable for some use cases like games."]	3.0	38
`allowPaymentRequest`	60	15	56–83	47	No	57	56–83	43	No	7.0	No
`browsingTopics`	115	115	No	101	No	115	No	77	No	23.0	115
`contentDocument`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`contentWindow`	1	12	1	8	3	18	4	10.1	1	1.0	4.4
`credentialless`	110	110	No	96	No	110	No	74	No	21.0	110
`csp`	61	79	No	48	No	61	No	45	No	8.0	61
`featurePolicy`	74	79	69	62	No	74	No	53	No	11.0	74
`frameBorder`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`getSVGDocument`	1	12	3.5	≤12.1	3.1	18	4	≤12.1	2	1.0	3
`height`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`loading`	77	79	121	60	16.4	77	121	55	16.4	12.0	77
`longDesc`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`marginHeight`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`marginWidth`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`name`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`privateToken`	117	117	No	103	No	117	No	78	No	24.0	117
`referrerPolicy`	5251–52	79	50	3938–39	14	5251–52	50	41	14	6.05.0–6.0	5251–52

`sandbox`	5 До Chrome 50, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.	12	17 Ранее, тип `sandbox` был `DOMString` вместо `DOMSettableTokenList`. Это было исправлено в Firefox 29. В других браузерах свойство может по-прежнему реализовываться как `DOMString` , так как это изменение спецификации появилось поздно.	15 До Opera 37, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.	5	18 До Chrome Android 50, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.	17 Ранее, тип `sandbox` был `DOMString` вместо `DOMSettableTokenList`. Это было исправлено в Firefox for Android 29. В других браузерах свойство может по-прежнему реализовываться как `DOMString` , так как это изменение спецификации появилось поздно.	14 До Opera Android 37, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.	4	1.0 До Samsung Internet 5.0, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.	≤37 До WebView 50, это свойство возвращало устаревшее свойство child `DOMSettableTokenList` вместо `DOMTokenList`.
`scrolling`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`sharedStorageWritable`	124	124	Нет	110	Нет	124	Нет	82	Нет	27.0	124
`src`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4
`srcdoc`	20	79	25	15	6	25	25	14	6	1.5	4.4
`width`	1	12	1	≤12.1	3	18	4	≤12.1	1	1.0	4.4

См. также

Элемент HTML, реализующий этот интерфейс: <iframe>

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