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