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