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.

EventTarget

Node

Element

HTMLElement

HTMLIFrameElementInstance 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 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`

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

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

*Inherits methods from its parent, `HTMLElement`*.

Specifications
--------------

| Specification |
| --- |
| HTML Standard # htmliframeelement |

Browser compatibility
---------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

See also
--------

* The HTML element implementing this interface: `<iframe>`