Document : propriété fullscreenEnabled
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 fullscreenEnabled de l'interface Document indique si le mode plein écran est disponible ou non.
Le mode plein écran n'est disponible que pour une page qui n'a pas de plug-ins en fenêtre dans l'un de ses documents, et si tous les éléments HTML <iframe> contenant le document ont leur attribut allowfullscreen défini.
Bien que cette propriété soit en lecture seule, elle ne lèvera pas d'erreur si elle est modifiée (même en mode strict) ; le mutateur est une opération nulle et sera ignoré.
Valeur
Une valeur booléenne qui est true si le document et les éléments qu'il contient peuvent être placés en mode plein écran en appelant Element.requestFullscreen(). Si le mode plein écran n'est pas disponible, cette valeur est false.
Exemples
Dans cet exemple, avant de tenter de passer en mode plein écran pour un élément HTML <video>, la valeur de fullscreenEnabled est vérifiée afin d'éviter de faire la tentative lorsque ce n'est pas disponible.
function requestFullscreen() {
if (document.fullscreenEnabled) {
videoElement.requestFullscreen();
} else {
console.log(
"Votre navigateur ne peut pas utiliser le mode plein écran pour le moment",
);
}
}
Spécifications
| Specification |
|---|
| Fullscreen API # ref-for-dom-document-fullscreenenabled① |
Compatibilité des navigateurs
Voir aussi
- L'API Fullscreen
- Guide de l'API Fullscreen
- La méthode
Element.requestFullscreen() - La méthode
Document.exitFullscreen() - La propriété
Document.fullscreenElement - La pseudo-classe
:fullscreenet le pseudo-élément::backdrop - L'attribut HTML
allowfullscreende l'élément HTML<iframe>