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.
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