Element.requestFullscreen()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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.

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

js
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

Specification
Fullscreen API Standard
# ref-for-dom-element-requestfullscreen①

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi