Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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 null

Ces 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