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
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
Spécification | Statut | Commentaire |
---|---|---|
Fullscreen API La définition de 'Element.requestFullScreen()' dans cette spécification. |
Standard évolutif | Initial definition |
Compatibilité des navigateurs
BCD tables only load in the browser