HTMLIFrameElement

The HTMLIFrameElement interface provides special properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25  501,20  501,30  491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="/docs/Web/API/HTMLIFrameElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLIFrameElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

Inherits properties from its parent, HTMLElement.

HTMLIFrameElement.align: Is a DOMString that specifies the alignment of the frame with respect to the surrounding context.
HTMLIFrameElement.allow: Is a list of origins the the frame is allowed to display content from. This attribute also accepts the values self and src which represent the origin in the iframe's src attribute. The default value is src.
HTMLIFrameElement.allowfullscreen: Is a Boolean indicating whether the inline frame is willing to be placed into full screen mode. See Using full-screen mode for details.
HTMLIFrameElement.allowPaymentRequest: Is a Boolean indicating whether the Payment Request API may be invoked inside a cross-origin iframe.
HTMLIFrameElement.contentDocument Read only: Returns a Document, the active document in the inline frame's nested browsing context.
HTMLIFrameElement.contentWindow Read only: Returns a WindowProxy, the window proxy for the nested browsing context.
HTMLIFrameElement.csp: Specifies the Content Security Policy that an embedded document must agree to enforce upon itself.
HTMLIFrameElement.frameBorder: Is a DOMString that indicates whether to create borders between frames.
HTMLIFrameElement.height: Is a DOMString that reflects the height HTML attribute, indicating the height of the frame.
HTMLIFrameElement.longDesc: Is a DOMString that contains the URI of a long description of the frame.
HTMLIFrameElement.marginHeight: Is a DOMString being the height of the frame margin.
HTMLIFrameElement.marginWidth: Is a DOMString being the width of the frame margin.
HTMLIFrameElement.name: Is a DOMString that reflects the name HTML attribute, containing a name by which to refer to the frame.
HTMLIFrameElement.featurePolicy Read only: Returns the FeaturePolicy interface which provides a simple API for introspecting the feature policies applied to a specific document.
HTMLIFrameElement.referrerPolicy: Is a DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use when fetching the linked resource.
HTMLIFrameElement.sandbox: Is a DOMSettableTokenList that reflects the sandbox HTML attribute, indicating extra restrictions on the behavior of the nested content.
HTMLIFrameElement.scrolling: Is a DOMString that indicates whether the browser should provide scrollbars for the frame.
HTMLIFrameElement.src: Is a DOMString that reflects the src HTML attribute, containing the address of the content to be embedded. Note that programatically removing an <iframe>'s src attribute (e.g. via Element.removeAttribute()) causes about:blank to be loaded in the frame in Firefox (from version 65), Chromium-based browsers, and Safari/iOS.
HTMLIFrameElement.srcdoc: Is a DOMString that represents the content to display in the frame.
HTMLIFrameElement.width: Is a DOMString that reflects the width HTML attribute, indicating the width of the frame.

Methods

Inherits properties from its parent, HTMLElement.

Specifications

Specification	Status	Comment
HTML Living Standard The definition of 'HTMLIFrameElement' in that specification.	Living Standard	The following property has been added: `allowFullscreen`.
HTML5 The definition of 'HTMLIFrameElement' in that specification.	Recommendation	The following properties are now obsolete: `scrolling`, `marginWidth`, `marginHeight`, `longDesc`, `frameBorder`, and `align`. The following properties have been added: `srcdoc`, `sandbox`, and `contentWindow`.
Document Object Model (DOM) Level 2 HTML Specification The definition of 'HTMLIFrameElement' in that specification.	Obsolete	The `contentDocument` property has been added.
Document Object Model (DOM) Level 1 Specification The definition of 'HTMLIFrameElement' in that specification.	Obsolete	Initial definition.

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`HTMLIFrameElement`	Chrome Full support Yes	Edge Full support 12	Firefox Full support 1	IE Full support Yes	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`align` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`allow`	Chrome Full support 60	Edge Full support ≤79	Firefox Full support 74	IE ?	Opera Full support 53	Safari Full support Yes	WebView Android Full support 66	Chrome Android Full support 66	Firefox Android No support No	Opera Android Full support 47	Safari iOS Full support Yes	Samsung Internet Android Full support 9.0
`allowFullscreen`	Chrome Full support 38	Edge Full support ≤18	Firefox Full support 22 Full support 22 No support 9 — 18 Alternate Name Alternate Name Uses the non-standard name: `mozAllowFullScreen`	IE No support No	Opera Full support 25	Safari Full support 10	WebView Android Full support 38	Chrome Android Full support 38	Firefox Android Full support 22 Full support 22 No support 9 — 18 Alternate Name Alternate Name Uses the non-standard name: `mozAllowFullScreen`	Opera Android Full support 25	Safari iOS Full support 10	Samsung Internet Android Full support 3.0
`allowPaymentRequest` Experimental	Chrome Full support 60 Disabled Full support 60 Disabled Disabled From version 60: this feature is behind the `#web-payments` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Edge Full support 15	Firefox Full support 56	IE ?	Opera No support No	Safari ?	WebView Android No support No	Chrome Android Full support 61 Disabled Full support 61 Disabled Disabled From version 61: this feature is behind the `#web-payments` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support Yes	Opera Android No support No	Safari iOS ?	Samsung Internet Android No support No
`contentDocument`	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE Full support 8	Opera Full support Yes	Safari Full support 10	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 4	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`contentWindow`	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 8	Opera Full support 8	Safari Full support 3	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support 10.1	Safari iOS Full support 1	Samsung Internet Android Full support 1.0
`csp` Experimental	Chrome Full support 61	Edge Full support ≤79	Firefox ?	IE ?	Opera Full support 48	Safari ?	WebView Android Full support 61	Chrome Android Full support 61	Firefox Android ?	Opera Android Full support 45	Safari iOS ?	Samsung Internet Android Full support 8.0
`featurePolicy` Experimental	Chrome Full support 74 Notes Full support 74 Notes Notes Chrome Platform Status incorrectly describes this variable as `document.policy`. It was renamed in bug 917057 before being shipped in bug 703703. No support 73 — 74 Disabled Disabled From version 73 until version 74 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags. No support 69 — 73 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 69 until version 73 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Edge Full support 79 Notes Full support 79 Notes Notes Edge Platform Status incorrectly describes this variable as `document.policy`. It was renamed in bug 917057 before being shipped in bug 703703.	Firefox Full support 69 Disabled Full support 69 Disabled Disabled From version 69: this feature is behind the `dom.security.featurePolicy.webidl.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config. No support 65 — 69 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 65 until version 69 (exclusive): this feature is behind the `dom.security.featurePolicy.webidl.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE No support No	Opera Full support 62 Full support 62 No support 60 — 62 Disabled Disabled From version 60 until version 62 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`). No support 56 — 60 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 56 until version 60 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`).	Safari No support No	WebView Android Full support 74 Notes Full support 74 Notes Notes Chrome Platform Status incorrectly describes this variable as `document.policy`. It was renamed in bug 917057 before being shipped in bug 703703.	Chrome Android Full support 74 Notes Full support 74 Notes Notes Chrome Platform Status incorrectly describes this variable as `document.policy`. It was renamed in bug 917057 before being shipped in bug 703703. No support 73 — 74 Disabled Disabled From version 73 until version 74 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags. No support 69 — 73 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 69 until version 73 (exclusive): this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`). To change preferences in Chrome, visit chrome://flags.	Firefox Android Full support 65 Alternate Name Disabled Full support 65 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 65: this feature is behind the `dom.security.featurePolicy.webidl.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 48 Alternate Name Disabled Full support 48 Alternate Name Disabled Alternate Name Uses the non-standard name: `policy` Disabled From version 48: this feature is behind the `#enable-experimental-productivity-features` preference (needs to be set to `Enabled`).	Safari iOS No support No	Samsung Internet Android Full support 11.0
`frameBorder` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`height`	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`longDesc` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`marginHeight` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`marginWidth` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`name`	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`referrerPolicy`	Chrome Full support 51	Edge Full support 79	Firefox Full support 50	IE No support No	Opera Full support 38	Safari Full support 11.1	WebView Android Full support 51	Chrome Android Full support 51	Firefox Android Full support 50	Opera Android Full support 41	Safari iOS No support No	Samsung Internet Android Full support 5.0
`sandbox`	Chrome Full support 43 Notes Full support 43 Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Edge Full support 12	Firefox Full support 17 Notes Full support 17 Notes Notes Previously, the type of `sandbox` was a `DOMString` instead of a `DOMSettableTokenList`. This has been fixed with Firefox 29. Other browsers may still implement the property as `DOMString` since it was a late change in the specification.	IE ?	Opera Full support Yes Notes Full support Yes Notes Notes Before Opera 37, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Safari Full support 6	WebView Android Full support Yes Notes Full support Yes Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Chrome Android Full support 18 Notes Full support 18 Notes Notes Before Chrome 50, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Firefox Android Full support 17 Notes Full support 17 Notes Notes Previously, the type of `sandbox` was a `DOMString` instead of a `DOMSettableTokenList`. This has been fixed with Firefox 29. Other browsers may still implement the property as `DOMString` since it was a late change in the specification.	Opera Android Full support Yes Notes Full support Yes Notes Notes Before Opera 37, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0 Notes Full support 1.0 Notes Notes Before Samsung Internet 5.0, this property returned the deprecated child `DOMSettableTokenList` instead of `DOMTokenList`.
`scrolling` Deprecated	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`setNfcFocus` Non-standard	Chrome No support No	Edge No support No	Firefox No support No Notes No support No Notes Notes Supported in chrome code only since Firefox version 47.	IE No support No	Opera No support No	Safari No support No	WebView Android No support No	Chrome Android No support No	Firefox Android No support No	Opera Android No support No	Safari iOS No support No	Samsung Internet Android No support No
`src`	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`srcdoc`	Chrome Full support 43	Edge Full support 79	Firefox Full support 25	IE No support No	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support 18	Firefox Android Full support 25	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support 1.0
`width`	Chrome Full support 43	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support 6	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.
Non-standard. Expect poor cross-browser support.: Non-standard. Expect poor cross-browser support.
Deprecated. Not for use in new websites.: Deprecated. Not for use in new websites.
See implementation notes.: See implementation notes.
User must explicitly enable this feature.: User must explicitly enable this feature.
Uses a non-standard name.: Uses a non-standard name.

Properties

Methods

Specifications

Browser compatibility

Legend

See also