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

Voir aussi