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
# ref-for-dom-element-requestfullscreen①

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
requestFullscreen
options.navigationUI parameter
options.screen parameter
Experimental
Returns a Promise

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Uses a non-standard name.
Requires a vendor prefix or different name for use.
Has more compatibility info.

Voir aussi