Node : propriété previousSibling

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.

En savoir plus
Voir la compatibilité complète

La propriété en lecture seule previousSibling de l'interface Node retourne le nœud précédant immédiatement le nœud défini dans la liste childNodes de son parent, ou null si le nœud défini est le premier de cette liste.

Note : Les navigateurs insèrent des nœuds texte dans un document pour représenter les espaces dans le balisage source. Par conséquent, un nœud obtenu par exemple avec 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·ice comptait obtenir.

La section Travailler avec les espaces blancs dans le DOM contient plus d'informations sur ce comportement.

Vous pouvez utiliser previousElementSibling pour obtenir le nœud élément précédent (en ignorant les nœuds texte et tout autre nœud non élément).

Pour naviguer dans l'autre sens à travers la liste des nœuds enfants, utilisez Node.nextSibling.

<span id="b0"></span><span id="b1"></span><span id="b2"></span>

document.getElementById("b1").previousSibling; // <span id="b0">
document.getElementById("b2").previousSibling.id; // "b1"

Second exemple

Dans cet exemple, il y a des nœuds texte d'espacement (sauts de ligne) entre les éléments HTML <span>.

html

<span id="b0"></span>
<span id="b1"></span>
<span id="b2"></span>

document.getElementById("b1").previousSibling; // #text
document.getElementById("b1").previousSibling.previousSibling; // <span id="b0">
document.getElementById("b2").previousSibling.previousSibling; // <span id="b1">
document.getElementById("b2").previousSibling; // #text
document.getElementById("b2").previousSibling.id; // undefined