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 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 à 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>, 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 et fullscreenerror, 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

Nous convertissons les données de compatibilité dans un format JSON. Ce tableau de compatibilité utilise encore l'ancien format car nous n'avons pas encore converti les données qu'il contient. Vous pouvez nous aider en contribuant !

Fonctionnalité Chrome Firefox Internet Explorer Edge Opera Safari
Support basique (Oui)webkit[1] 9.0 (9.0) as mozRequestFullScreen[2]
47.0 (47.0) (behind full-screen-api.unprefix.enabled		 11ms[3] (Oui)[3] ? ?
Fonctionnalité Chrome Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Support basique (Oui)webkit[1] (Oui) 9.0 (9.0) as mozRequestFullScreen[2]
47.0 (47.0) (behind full-screen-api.unprefix.enabled		 ? ? ?

[1] Également implémenté en tant que webkitRequestFullScreen.

[2] Implémenté en tant que mozRequestFullScreen (remarquez le S majuscule pour Screen). Avant Firefox 44, Gecko autorisait incorrectement les éléments présents dans une  <frame> ou un <object> de demander, et d'obtenir, le mode plein écran. Dans les versions 44 et supérieures de Firefox, ceci a été corrigé : seuls les éléments dans le plus haut niveau du document ou dans une <iframe> avec l'attribut allowfullscreen peuvent être affichés en plein écran.

[3] Voir la documentation sur MSDN.

Voir aussi