CKTIS / JavaScript
Recherche par identifiant et focus : getElementById() et activeElement
`document.getElementById(id)` recherche un élément par son identifiant, tandis que `document.activeElement` indique où se trouve le focus clavier du point de vue du document.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.getElementById(id) // call: Element or null
document.activeElement // read-only property: Element or nulldocument.getElementById(id) est une méthode qui recherche une valeur id dans l’arbre du document concerné. Passez l’identifiant seul, sans le préfixe # des sélecteurs CSS. La recherche respecte la casse. La méthode renvoie un Element, ou null si elle ne trouve rien. Les identifiants doivent être uniques dans un même arbre ; en cas de doublon, la méthode renvoie le premier élément correspondant dans l’ordre de l’arbre.
La recherche ignore les nœuds détachés du document et ne descend ni dans les arbres du Shadow DOM ni dans les documents des éléments iframe. DocumentFragment, et donc ShadowRoot, possède sa propre méthode getElementById() ; un Element ordinaire ne la possède pas. Testez le résultat avant de l’utiliser pour écarter null, ou utilisez ?. si l’élément peut manquer.
document.activeElement est une propriété en lecture seule, pas une méthode. Elle renvoie l’Element qui représente le focus clavier courant du point de vue de ce document. Si le focus se trouve dans un arbre du Shadow DOM ou dans un document intégré, le document extérieur voit respectivement l’hôte du Shadow DOM ou l’élément iframe. Pour aller plus loin, lisez activeElement sur un ShadowRoot accessible ou sur le document du cadre s’il est de même origine. Si le focus correspond au document lui-même, la propriété renvoie son body ou, à défaut, son documentElement s’il existe. Elle renvoie null si aucun élément ni aucune valeur de repli ne s’applique à l’arbre interrogé.
Le focus ne correspond pas à la sélection de texte, et rechercher un élément ne lui donne pas le focus. Si target n’est pas null, document.activeElement === target vérifie qu’il s’agit du même nœud. Relisez la propriété après un changement de focus : une valeur mémorisée ne se met pas à jour toute seule. Ces API appartiennent à la plateforme web, pas à ECMAScript 2024 ; un environnement sans DOM de navigateur n’est pas tenu de fournir document.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>ID lookup and focus</title>
</head>
<body>
<script>
{
const other = document.createElement('input');
const target = document.createElement('input');
target.id = 'cktis-target';
document.body.append(other, target);
try {
const found = document.getElementById('cktis-target');
other.focus();
console.log(found === target);
console.log(found === document.activeElement);
found?.focus();
console.log(found === document.activeElement);
console.log(document.getElementById('CKTIS-target') === null);
} finally {
other.remove();
target.remove();
}
}
</script>
</body>
</html>Résultat
true false true true
Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un onglet du navigateur au premier plan, puis consultez la console du navigateur. Si le navigateur autorise le focus par script, les trois premières lignes montrent que la cible est trouvée, qu’elle n’a pas le focus au départ, puis qu’elle le reçoit. La dernière ligne confirme que le changement de casse empêche la correspondance.
Leçons associées
- JavaScript · Leçon 18 · Avancé · Version : 4