Document : méthode hasFocus()
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 méthode hasFocus() de l'interface Document retourne une valeur booléenne indiquant si le document ou un élément à l'intérieur du document a la sélection.
Cette méthode peut être utilisée pour déterminer si l'élément actif dans un document a la sélection.
Note : Lors de l'affichage d'un document, un élément ayant la sélection est toujours l'élément actif dans le document, mais un élément actif n'a pas nécessairement la sélection. Par exemple, un élément actif dans une fenêtre contextuelle qui n'est pas au premier plan n'a pas la sélection.
Syntaxe
hasFocus()
Paramètres
Aucun.
Valeur retournée
false si l'élément actif dans le document n'a pas la sélection ;
true si l'élément actif dans le document a la sélection.
Exemples
Vérifier si le document a la sélection
L'exemple suivant vérifie si le document a la sélection ou non.
Une fonction appelée checkPageFocus() met à jour un élément paragraphe selon le résultat de document.hasFocus().
Ouvrir une nouvelle fenêtre fera perdre la sélection au document et revenir à la fenêtre d'origine lui rendra la sélection.
<p id="log">Vérification du résultat de la sélection affichée ici.</p>
<button id="newWindow">Ouvrir une nouvelle fenêtre</button>
const body = document.querySelector("body");
const log = document.getElementById("log");
function checkDocumentFocus() {
if (document.hasFocus()) {
log.textContent = "Ce document a la sélection.";
body.style.background = "white";
} else {
log.textContent = "Ce document n'a pas la sélection.";
body.style.background = "gray";
}
}
function openWindow() {
window.open(
"https://www.supremezsy.dpdns.org/",
"MDN",
"width=640,height=320,left=150,top=150",
);
}
document.getElementById("newWindow").addEventListener("click", openWindow);
setInterval(checkDocumentFocus, 300);
Spécifications
| Specification |
|---|
| HTML # dom-document-hasfocus-dev |
Compatibilité des navigateurs
Voir aussi
- La propriété
Document.activeElement - Utiliser l'API Page Visibility