--- title: element.nextSibling slug: Web/API/Node/nextSibling tags: - API - DOM - Noeuds - Propriétés translation_of: Web/API/Node/nextSibling ---

{{APIRef("DOM")}}

La propriété en lecture seule  Node.nextSibling renvoie le nœud (node) suivant immédiatement le nœud spécifié dans la liste des enfants ( {{domxref("Node.childNodes","childNodes")}}) de son nœud parent, ou null si le nœud spécifié est le dernier dans cette liste.

Syntaxe

nextNode = node.nextSibling

Notes

Les navigateurs basés sur Gecko insèrent des nœuds texte dans un document pour représenter des espaces vides dans le balisage source. Par conséquent, un nœud obtenu par exemple via Node.firstChild ou Node.previousSibling peut faire référence à un nœud texte contenant des espaces plutôt qu'au véritable élément que l'auteur comptait obtenir.

Consultez Gestion des espaces dans le DOM et Why are some Text nodes empty? dans la FAQ DOM 3 du W3C pour plus d'informations.

{{domxref("Element.nextElementSibling")}} peut être utilisé pour obtenir l'élément suivant en ignorant les noeuds d'espace.

Exemple

<div id="div-01">Here is div-01</div>
<div id="div-02">Here is div-02</div>

<script type="text/javascript">
var el = document.getElementById('div-01').nextSibling,
    i = 1;

console.log('Siblings of div-01:');

while (el) {
  console.log(i + '. ' + el.nodeName);
  el = el.nextSibling;
  i++;
}

</script>

/**************************************************
  Ce qui suit est écrit sur la console pendant le chargement:

     Siblings of div-01

      1. #text
      2. DIV
      3. #text
      4. SCRIPT

**************************************************/

Dans cet exemple, on peut voir que des nœuds #text sont insérés dans le DOM là où des espaces se trouvent dans le code source entre les balises (c'est-à-dire après la balise de fermeture d'un élément et avant la balise d'ouverture du suivant). Aucun espace n'est créé entre les éléments insérés par l'instruction document.write .

L'inclusion possible de nœuds textes dans le DOM doit être prise en compte pour le parcours du DOM à l'aide de nextSibling. Consultez les ressources dans la section Notes .

Spécification

Compatibilité des navigateurs

{{Compat("api.Node.nextSibling")}}

Voir aussi

{{domxref("Element.nextElementSibling")}}