Node : propriété nextSibling
Baseline
Large disponibilité
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 nextSibling de l'interface Node retourne le nœud immédiatement suivant celui défini dans la liste childNodes de son parent, ou retourne null si le nœud défini est le dernier enfant de l'élément parent.
Note :
Les navigateurs insèrent des nœuds Text dans un document pour représenter les espaces blancs dans le code source.
Par conséquent, un nœud obtenu, par exemple, en utilisant Node.firstChild ou Node.previousSibling peut faire référence à un nœud texte d'espacement plutôt qu'à l'élément réel que l'auteur·ice voulait obtenir.
La section Travailler avec les espaces blancs dans le DOM contient plus d'informations sur ce comportement.
Vous pouvez utiliser nextElementSibling pour obtenir l'élément suivant en ignorant les nœuds d'espacement, les autres textes entre les éléments ou les commentaires.
Pour naviguer dans la liste des nœuds enfants dans le sens inverse, utilisez Node.previousSibling.
Valeur
Un objet Node représentant le nœud suivant du nœud actuel, ou null s'il n'y en a pas.
Exemples
<div id="div-1">C'est le div-1</div>
<div id="div-2">C'est le div-2</div>
<br />
<output><em>Pas calculé.</em></output>
let el = document.getElementById("div-1").nextSibling;
let i = 1;
let resultat = "Voisins de div-1:\n";
while (el) {
resultat += `${i}. ${el.nodeName}\n`;
el = el.nextSibling;
i++;
}
const sortie = document.querySelector("output");
sortie.innerText = resultat;
Spécifications
| Spécification |
|---|
| DOM # ref-for-dom-node-nextsibling① |
Compatibilité des navigateurs
Voir aussi
- La propriété
Element.nextElementSibling - La propriété
Node.previousSibling