Document: fullscreenEnabled property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Fullscreen API")}}
The read-only **fullscreenEnabled** property on the {{domxref("Document")}} interface indicates whether or not fullscreen mode is available.
fullscreen mode is available only for a page that has no windowed plug-ins in any of its documents, and if all {{HTMLElement("iframe")}} elements which contain the document have their [allowfullscreen](/en-US/docs/Web/HTML/Reference/Elements/iframe#allowfullscreen) attribute set.
Although this property is read-only, it will not throw if it is modified (even in strict mode); the setter is a no-operation and it will be ignored.
Value
A boolean value which is true if the document and the elements within can be placed into fullscreen mode by calling {{domxref("Element.requestFullscreen()")}}. If fullscreen mode isn't available, this value is false.
Examples
In this example, before attempting to request fullscreen mode for a {{htmlElement("video")}} element, the value of fullscreenEnabled is checked, in order to avoid making the attempt when not available.
function requestFullscreen() {
if (document.fullscreenEnabled) {
videoElement.requestFullscreen();
} else {
console.log("Your browser cannot use fullscreen right now");
}
}Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- Fullscreen API
- Guide to the Fullscreen API
- {{domxref("Element.requestFullscreen()")}}
- {{domxref("Document.exitFullscreen()")}}
- {{domxref("Document.fullscreenElement")}}
- {{cssxref(":fullscreen") }} and {{cssxref("::backdrop")}}
- The {{HTMLElement("iframe")}} [
allowfullscreen](/en-US/docs/Web/HTML/Reference/Elements/iframe#allowfullscreen)
attribute