Element.requestFullscreen()
La méthode Element.requestFullscreen()
envoie une requête asynchrone pour que l'élément soit affiché en plein écran.
Il n'y a aucune garantie que l'élément passera effectivement en mode plein écran. Si la permission d'entrer en plein écran est acquise, le document recevra un événement fullscreenchange
(en-US) pour l'informer qu'il est désormais en mode plein écran. Si la permission est refusée, le document recevra un événement fullscreenerror
(en-US) à la place.
Cette méthode doit être invoquée par l'interaction d'un utilisateur ou un changement d'orientation du périphérique, sinon elle échouera.
Note : Seuls les éléments présents dans l'espace de noms (namespace) HTML (c'est à dire, les éléments qui font partie du standard HTML), ainsi que les éléments <svg>
et <math>
(en-US), qui se trouvent dans le plus haut niveau du document ou dans une <iframe>
avec l'attribut allowfullscreen
peuvent être affichés en plein écran. Cela signifie que les éléments se trouvant dans une <frame>
ou un <object>
ne le peuvent pas.
Syntaxe
js
Element.requestFullscreen();
Exemple
Avant d'appeler requestFullScreen()
, mettez en place des gestionnaires (handlers) pour les évenements fullscreenchange
(en-US) et fullscreenerror
(en-US), pour savoir lorsque vous avez réussi à passer en mode plein écran (ou lorsque la permission de le faire a été refusée).
tbd
Spécifications
Specification |
---|
Fullscreen API Standard # ref-for-dom-element-requestfullscreen① |
Compatibilité des navigateurs
BCD tables only load in the browser