Element.requestFullscreen()
The Element.requestFullscreen()
method issues an asynchronous request to make the element be displayed full-screen.
It's not guaranteed that the element will be put into full screen mode. If permission to enter full screen mode is granted, the document will receive a fullscreenchange
event to let it know that it's now in full screen mode. If permission is denied, the document receives a fullscreenerror
event instead.
Only elements in the top-level document or in an <iframe>
with the allowfullscreen
attribute can be displayed full-screen. This means that elements inside a <frame>
or an <object>
can't.
Syntax
elt.requestFullscreen();
Specifications
Specification | Status | Comment |
---|---|---|
Fullscreen API The definition of 'Element.requestFullScreen()' in that specification. |
Living Standard | Initial definition |
Browser compatibility
Feature | Chrome | Firefox | Internet Explorer | Edge | Opera | Safari |
---|---|---|---|---|---|---|
Basic support | (Yes)webkit[1] | 9.0 (9.0) as mozRequestFullScreen [2]47.0 (47.0) (behind full-screen-api.unprefix.enabled |
11ms[3] | (Yes)[3] | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | ? | 9.0 (9.0) as mozRequestFullScreen [2]47.0 (47.0) (behind full-screen-api.unprefix.enabled |
? | ? | ? |
[1] Also implemented as webkitRequestFullScreen
.
[2] Implemented as mozRequestFullScreen
(notice the capital S for Screen). Before Firefox 44, Gecko incorrectly allowed elements inside a <frame>
or an <object>
to request, and to be granted, fullscreen. In Firefox 44 and onwards this has been fixed: only elements in the top-level document or in an <iframe>
with the allowfullscreen
attribute can be displayed fullscreen.
[3] See documentation on MSDN.
See also
- Using full-screen mode
Element.requestFullscreen()
Document.exitFullscreen()
Document.fullscreen
Document.fullscreenElement
:fullscreen
allowfullscreen
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/element/requestfullscreen