Document : propriété visibilityState
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété en lecture seule visibilityState de l'interface Document retourne la visibilité du document. Elle peut être utilisée pour vérifier si le document est en arrière-plan, dans une fenêtre minimisée ou autrement non visible pour l'utilisateur·ice.
Lorsque la valeur de cette propriété change, l'évènement visibilitychange est envoyé au Document.
La propriété Document.hidden fournit un moyen alternatif de déterminer si la page est cachée.
Valeur
Une chaîne de caractères avec l'une des valeurs suivantes :
visible-
Le contenu de la page peut être au moins partiellement visible. En pratique, cela signifie que la page est l'onglet au premier plan d'une fenêtre non minimisée.
-
Le contenu de la page n'est pas visible pour l'utilisateur·ice. En pratique, cela signifie que le document est soit un onglet en arrière-plan, soit une partie d'une fenêtre minimisée, ou que le verrouillage de l'écran du système d'exploitation est actif.
Exemples
document.addEventListener("visibilitychange", () => {
console.log(document.visibilityState);
// Modifier le comportement…
});
Spécifications
| Specification |
|---|
| HTML # dom-document-visibilitystate |
Compatibilité des navigateurs
Voir aussi
- La propriété
Document.hidden - L'API Page Visibility