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.
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.
Inherits properties from its parent, HTMLElement
.
HTMLIFrameElement.align
Deprecated
A string that specifies the alignment of the frame with respect to the surrounding context.
HTMLIFrameElement.allow
A list of origins 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
Experimental
A boolean value indicating whether the inline frame is willing to be placed into full screen mode. See Using fullscreen mode for details.
HTMLIFrameElement.allowPaymentRequest
Deprecated Non-standard
A boolean value 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.credentialless
Experimental
A boolean value indicating whether the <iframe>
is credentialless, meaning that its content is loaded in a new, ephemeral context. This context does not have access to the parent context's shared storage and credentials. In return, the Cross-Origin-Embedder-Policy
(COEP) embedding rules can be lifted, so documents with COEP set can embed third-party documents that do not. See IFrame credentialless for a deeper explanation.
HTMLIFrameElement.csp
Experimental
Specifies the Content Security Policy that an embedded document must agree to enforce upon itself.
HTMLIFrameElement.frameBorder
Deprecated
A string that indicates whether to create borders between frames.
HTMLIFrameElement.height
A string that reflects the height
HTML attribute, indicating the height of the frame.
HTMLIFrameElement.longDesc
Deprecated
A string that contains the URI of a long description of the frame.
HTMLIFrameElement.marginHeight
Deprecated
A string being the height of the frame margin.
HTMLIFrameElement.marginWidth
Deprecated
A string being the width of the frame margin.
HTMLIFrameElement.name
A string that reflects the name
HTML attribute, containing a name by which to refer to the frame.
HTMLIFrameElement.featurePolicy
Read only Experimental
Returns the FeaturePolicy
interface which provides a simple API for introspecting the Permissions Policies applied to a specific document.
HTMLIFrameElement.referrerPolicy
A string that reflects the referrerPolicy
HTML attribute indicating which referrer to use when fetching the linked resource.
HTMLIFrameElement.sandbox
A DOMTokenList
that reflects the sandbox
HTML attribute, indicating extra restrictions on the behavior of the nested content.
HTMLIFrameElement.scrolling
Deprecated
A string that indicates whether the browser should provide scrollbars for the frame.
HTMLIFrameElement.src
A string that reflects the src
HTML attribute, containing the address of the content to be embedded. Note that programmatically 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
A string that represents the content to display in the frame.
HTMLIFrameElement.width
A string that reflects the width
HTML attribute, indicating the width of the frame.
Inherits methods from its parent, HTMLElement
.
Specification |
---|
HTML Standard # htmliframeelement |
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
HTMLIFrameElement |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | ≤37 | 18 | 4 | ≤12.1 | 1 | 1.0 |
align |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
allow |
60 | 79 | 74 | No | 47 | 11.1 | 60 | 60 | 79 | 44 | 11.3 | 8.0 |
allowFullscreen |
38 | 12 | 229–18 | No | 25 | 10.1 | 38 | 38 | 229–18 | 25 | 12Only available on iPad, not on iPhone. |
3.0 |
allowPaymentRequest |
60 | 15 | 56–83 | No | 47 | No | No | 57 | 56–83 | 43 | No | 7.0 |
contentDocument |
1 | 12 | 1 | 8 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
contentWindow |
1 | 12 | 1 | 5.5 | 8 | 3 | 4.4 | 18 | 4 | 10.1 | 1 | 1.0 |
csp |
61 | 79 | No | No | 48 | No | 61 | 61 | No | 45 | No | 8.0 |
featurePolicy |
74 | 79 | 69 | No | 62 | No | 74 | 74 | No | 53 | No | 11.0 |
frameBorder |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
getSVGDocument |
1 | 12 | 3.5 | 9 | ≤12.1 | 3.1 | 3 | 18 | 4 | ≤12.1 | 2 | 1.0 |
height |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
loading |
77 | 79 | No | No | 60 | 16.4 | 77 | 77 | No | 55 | 16.4 | 12.0 |
longDesc |
1 | 12 | 1 | 6 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
marginHeight |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
marginWidth |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
name |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
privateToken |
117 | 117 | No | No | 103 | No | 117 | 117 | No | No | No | No |
referrerPolicy |
5251–52 | 79 | 50 | No | 3938–39 | 14 | 5251–52 | 5251–52 | 50 | 41 | 14 | 6.05.0–6.0 |
sandbox |
5Before Chrome 50, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
12 | 17Previously, the type ofsandbox 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. |
10 | 15Before Opera 37, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
5 | ≤37Before WebView 50, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
18Before Chrome 50, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
17Previously, the type ofsandbox 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. |
14Before Opera 37, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
4 | 1.0Before Samsung Internet 5.0, this property returned the deprecated childDOMSettableTokenList instead of DOMTokenList . |
scrolling |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
src |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
srcdoc |
20 | 79 | 25 | No | 15 | 6 | 4.4 | 25 | 25 | 14 | 6 | 1.5 |
width |
1 | 12 | 1 | 5.5 | ≤12.1 | 3 | 4.4 | 18 | 4 | ≤12.1 | 1 | 1.0 |
<iframe>
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLIFrameElement