CKTIS / JavaScript
Navigation dans le DOM : enfants, nom de balise, parent et éléments frères
Lisez le nom de balise et naviguez entre les enfants directs, le parent et les éléments voisins. Découvrez quand une collection se met à jour et quand une propriété peut renvoyer `null`.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.children // HTMLCollection
element.tagName // string
element.parentElement // Element or null
element.previousElementSibling // Element or null
element.nextElementSibling // Element or nullCes cinq propriétés du DOM sont en lecture seule. Lisez-les avec la notation pointée, sans parenthèses d’appel. Elles font partie de l’API DOM, pas d’ECMAScript 2024 ; un environnement sans DOM ne les fournit pas.
element.children est une HTMLCollection dynamique des éléments enfants directs, dans l’ordre du DOM. Elle est vide en l’absence d’éléments enfants. element.childNodes est aussi dynamique, mais c’est une NodeList qui comprend tous les nœuds enfants directs, dont le texte et les commentaires. Une collection children déjà stockée se met à jour avec le DOM. Array.from(element.children) fige la liste et l’ordre des références dans un tableau, sans cloner les éléments.
element.tagName renvoie le nom qualifié de la balise sous forme de chaîne, préfixe compris s’il existe. Pour un élément de l’espace de noms HTML dans un document HTML, les lettres ASCII sont mises en majuscules, comme dans "DIV". Sinon, la casse est conservée, y compris pour le SVG dans un document HTML et le XHTML traité comme du XML. Pour tenir compte de l’espace de noms lors d’une comparaison, utilisez localName avec namespaceURI.
element.parentElement vient de Node. Cette propriété renvoie le parent direct si c’est un élément, sinon null, y compris en l’absence de parent. Sur l’élément racine d’un document, par exemple, parentElement vaut null, tandis que parentNode renvoie le Document.
previousElementSibling et nextElementSibling renvoient respectivement l’élément le plus proche avant ou après l’élément courant sous le même parent, ou null s’il n’y en a pas. Ces propriétés ignorent le texte et les commentaires, contrairement à previousSibling et nextSibling, qui peuvent renvoyer ces nœuds. Testez null avant de lire tagName, ou utilisez element.nextElementSibling?.tagName, qui donne undefined en l’absence d’élément frère suivant.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOM element traversal</title>
</head>
<body>
<script>
{
const doc = document.implementation.createHTMLDocument();
const box = doc.createElement('div');
const first = doc.createElement('span');
const second = doc.createElement('em');
box.append(first, ' ', doc.createComment('gap'), second);
const live = box.children;
const snapshot = Array.from(live);
console.log(JSON.stringify([live.length, box.childNodes.length, live[0].tagName]));
console.log(JSON.stringify([
first.parentElement?.tagName,
first.nextElementSibling?.tagName,
second.previousElementSibling?.tagName,
first.previousElementSibling,
second.nextElementSibling
]));
box.append(doc.createElement('strong'));
console.log(JSON.stringify([
live.length, snapshot.length,
doc.documentElement.parentElement,
doc.documentElement.parentNode === doc
]));
}
</script>
</body>
</html>Résultat
[2,4,"SPAN"] ["DIV","EM","SPAN",null,null] [3,2,null,true]
Enregistrez l’exemple dans un fichier `.html`, ouvrez-le dans un navigateur et consultez la console de développement. L’exemple utilise un document HTML séparé et ne modifie pas la page ouverte. L’espace et le commentaire comptent dans `childNodes`, mais pas dans `children` ; l’ajout d’un élément n’augmente que la longueur de la collection dynamique.
Leçons associées
- JavaScript · Leçon 34 · Intermédiaire · Version : 3
Sources
- Element: children property
- Element: tagName property
- Node: parentElement property
- Element: previousElementSibling property
- Element: nextElementSibling property
- Node: childNodes property
- HTMLCollection
- Element: localName property
- Element: namespaceURI property
- DOMImplementation: createHTMLDocument() method
- HTML Standard: Terminology
- ECMAScript 2024 Language Specification: Optional Chains