HTMLIFrameElement

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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.

EventTarget Node Element HTMLElement HTMLIFrameElement

Instance properties

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 string that indicates the Permissions Policy specified for this <iframe>.

HTMLIFrameElement.allowFullscreen

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.browsingTopics Experimental Non-standard

A boolean property specifying that the selected topics for the current user should be sent with the request for the associated <iframe>'s source. This reflects the browsingtopics content attribute value.

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.featurePolicy Read only Experimental

Returns the FeaturePolicy interface which provides a simple API for introspecting the Permissions Policies applied to a specific document.

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.loading

A string providing a hint to the browser that the iframe should be loaded immediately (eager) or on an as-needed basis (lazy). This reflects the loading HTML attribute.

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.referrerPolicy

A string that reflects the referrerPolicy HTML attribute indicating which referrer to use when fetching the linked resource.

HTMLIFrameElement.sandbox Read only

Returns 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.

Instance methods

Also inherits methods from its parent interface, HTMLElement.

HTMLIframeElement.getSVGDocument()

Returns the embedded SVG as a Document.

Specifications

Specification
HTML
# htmliframeelement

Browser compatibility

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLIFrameElement
adAuctionHeaders
Experimental
align
Deprecated
allow
allowFullscreen
allowPaymentRequest
DeprecatedNon-standard
browsingTopics
ExperimentalNon-standard
contentDocument
contentWindow
credentialless
Experimental
csp
Experimental
featurePolicy
Experimental
frameBorder
Deprecated
getSVGDocument
height
loading
longDesc
Deprecated
marginHeight
Deprecated
marginWidth
Deprecated
name
privateToken
Experimental
referrerPolicy
no-referrer-when-downgrade
origin-when-cross-origin
unsafe-url
sandbox
scrolling
Deprecated
sharedStorageWritable
Experimental
src
srcdoc
width

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Uses a non-standard name.
Has more compatibility info.

See also

  • The HTML element implementing this interface: <iframe>