HTMLIFrameElement.setVisible()

Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

The setVisible() method of the HTMLIFrameElement is used to change the visibility state of the browser <iframe>.

The visible state of a browser <iframe> has nothing to do with its actual visibility (which is handled through CSS). The visible state is used to define the level of resources required by the browser <iframe>. If the visible state is set to true, it means that the browser <iframe> should have high priority over the resources needed to render and handle its content. On the contrary, if its visible state is set to false, it has low priority over the resources it needs.

As an example, if the content of a browser <iframe> uses the window.requestAnimationFrame method and if the visible state is set to true, window.requestAnimationFrame will be called as often as necessary. However, if the visible state is set to false, window.requestAnimationFrame will be called only when there are free resources to do it.

Syntax

instanceOfHTMLIframeElement.setVisible(visible);

Returns

Void.

Parameters

visible
A Boolean that indicates if the browser <iframe> visible state is true or false.

Examples

var browser = document.querySelector('iframe');
browser.setVisible(true);

Specification

Not part of any specification.

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support No support 47 (47)[1] No support No support No support
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support No support No support No support No support No support No support No support

[1] Supported in chrome code only.

See also

Document Tags and Contributors

 Contributors to this page: chrisdavidmills, teoli, ajaybhat, kscarfone, Jeremie
 Last updated by: chrisdavidmills,