Document : propriété fullscreenElement
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La propriété en lecture seule fullscreenElement de l'interface Document retourne l'élément (Element) qui est actuellement affiché en mode plein écran dans ce document, ou null si le mode plein écran n'est pas actuellement utilisé.
Bien que cette propriété soit en lecture seule, elle ne générera pas d'erreur si elle est modifiée (même en mode strict) : le mutateur est une opération nulle et sera ignoré.
Valeur
L'objet Element qui est actuellement en mode plein écran ; si le mode plein écran n'est pas actuellement utilisé par le document, la valeur retournée est null. Si plusieurs éléments sont en mode plein écran, l'élément le plus haut (le plus récemment demandé) est retourné.
Exemples
Cet exemple présente une fonction, isVideoInFullscreen(), qui examine la valeur retournée par fullscreenElement ; si le document est en mode plein écran (fullscreenElement n'est pas null) et que la propriété nodeName de l'élément en plein écran est VIDEO, indiquant un élément HTML <video>, la fonction retourne true, indiquant que la vidéo est en mode plein écran.
function isVideoInFullscreen() {
if (document.fullscreenElement?.nodeName === "VIDEO") {
return true;
}
return false;
}
Spécifications
| Specification |
|---|
| Fullscreen API # ref-for-dom-document-fullscreenelement① |
Compatibilité des navigateurs
Voir aussi
- L'API Fullscreen
- Guide de l'API Fullscreen
- La méthode
Element.requestFullscreen() - La méthode
Document.exitFullscreen() - La pseudo-classe
:fullscreenet le pseudo-élément::backdrop - L'attribut HTML
allowfullscreende l'élément HTML<iframe>