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.
HTMLIFrameElement
Properties
Inherits properties from its parent, HTMLElement.
-
HTMLIFrameElement.alignDeprecated -
A string that specifies the alignment of the frame with respect to the surrounding context.
-
HTMLIFrameElement.allowExperimental -
A list of origins the frame is allowed to display content from. This attribute also accepts the values
selfandsrcwhich represent the origin in the iframe's src attribute. The default value issrc. -
HTMLIFrameElement.allowfullscreenExperimental -
A boolean value indicating whether the inline frame is willing to be placed into full screen mode. See Using fullscreen mode for details.
-
HTMLIFrameElement.allowPaymentRequestDeprecated -
A boolean value indicating whether the Payment Request API may be invoked inside a cross-origin iframe.
-
HTMLIFrameElement.contentDocumentRead only -
Returns a
Document, the active document in the inline frame's nested browsing context. -
HTMLIFrameElement.contentWindowRead 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.fetchpriority -
An optional
DOMStringrepresenting a hint given to the browser on how it should prioritize fetching of the iframe document relative to other iframe documents. If this value is provided, it must be one of the possible permitted values:highto fetch at a high priority,lowto fetch at a low priority, orautoto indicate no preference (which is the default). -
HTMLIFrameElement.frameBorderDeprecated -
A string that indicates whether to create borders between frames.
-
HTMLIFrameElement.height -
A string that reflects the
heightHTML attribute, indicating the height of the frame. -
HTMLIFrameElement.longDescDeprecated -
A string that contains the URI of a long description of the frame.
-
HTMLIFrameElement.marginHeightDeprecated -
A string being the height of the frame margin.
-
HTMLIFrameElement.marginWidthDeprecated -
A string being the width of the frame margin.
-
HTMLIFrameElement.name -
A string that reflects the
nameHTML attribute, containing a name by which to refer to the frame. -
HTMLIFrameElement.featurePolicyRead only Experimental -
Returns the
FeaturePolicyinterface which provides a simple API for introspecting the feature policies applied to a specific document. -
HTMLIFrameElement.referrerPolicyExperimental -
A string that reflects the
referrerpolicyHTML attribute indicating which referrer to use when fetching the linked resource. -
HTMLIFrameElement.sandbox -
A
DOMTokenListthat reflects thesandboxHTML attribute, indicating extra restrictions on the behavior of the nested content. -
HTMLIFrameElement.scrollingDeprecated -
A string that indicates whether the browser should provide scrollbars for the frame.
-
HTMLIFrameElement.src -
A string that reflects the
srcHTML attribute, containing the address of the content to be embedded. Note that programmatically removing an<iframe>'s src attribute (e.g. viaElement.removeAttribute()) causesabout:blankto 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
widthHTML attribute, indicating the width of the frame.
Methods
Inherits properties from its parent, HTMLElement.
Specifications
| Specification |
|---|
| HTML Standard # htmliframeelement |
Browser compatibility
| 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
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
align |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
allow |
60
|
79
|
74
|
No
|
53
|
11.1
|
66
|
66
|
79
|
47
|
11.3
|
9.0
|
allowFullscreen |
38
|
12
|
22
9-18
|
No
|
25
|
10.1
|
38
|
38
|
22
9-18
|
25
|
12
Only available on iPad, not on iPhone.
|
3.0
|
allowPaymentRequest |
60
|
15
|
56-83
|
No
|
No
|
No
|
No
|
61
|
56-83
|
No
|
No
|
No
|
contentDocument |
1
|
12
|
1
|
8
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
contentWindow |
1
|
12
|
1
|
5.5
|
8
|
3
|
1
|
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
65-69
|
No
|
62
|
No
|
74
|
74
|
No
|
53
|
No
|
11.0
|
fetchpriority |
101
|
101
|
No
|
No
|
No
|
No
|
101
|
101
|
No
|
No
|
No
|
No
|
frameBorder |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
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
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
loading |
77
|
79
|
No
|
No
|
60
|
No
See
bug 196698.
|
77
|
77
|
No
|
55
|
No
See
bug 196698.
|
12.0
|
longDesc |
1
|
12
|
1
|
6
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
marginHeight |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
marginWidth |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
name |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
referrerPolicy |
53
|
79
|
50
|
No
|
38
|
14
|
53
|
53
|
50
|
41
|
14
|
6.0
|
sandbox |
5
Before Chrome 50, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
12
|
17
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.
|
10
|
15
Before Opera 37, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
5
|
≤37
Before WebView 50, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
18
Before Chrome 50, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
17
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.
|
14
Before Opera 37, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
4
|
1.0
Before Samsung Internet 5.0, this property returned the deprecated child
DOMSettableTokenList instead of
DOMTokenList.
|
scrolling |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
src |
1
|
12
|
1
|
5.5
|
≤12.1
|
3
|
1
|
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
|
1
|
18
|
4
|
≤12.1
|
1
|
1.0
|
See also
- The HTML element implementing this interface:
<iframe>
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLIFrameElement
