Méthode HTML DOM Element compareDocumentPosition()

Définition et utilisation

compareDocumentPosition() Cette méthode compare deux nœuds et retourne un entier, décrivant leur position dans le document :

Valeur Signification
1 Les nœuds n'appartiennent pas au même document.
2 Le premier nœud est situé après le deuxième nœud.
4 Le premier nœud est situé avant le deuxième nœud.
8 Le premier nœud est situé à l'intérieur du deuxième nœud.
16 Le deuxième nœud est situé à l'intérieur du premier nœud.
32 Le nœud est une propriété sur le même élément.

Commentaire

La valeur de retour peut également être une combinaison de valeurs.

La valeur 20 signifie que le deuxième nœud est à l'intérieur du premier nœud (16) et que le premier nœud est avant le deuxième nœud (4).

Exemple

"p1" comparé à "p2" : où ils se trouvent :

const p1 = document.getElementById("p1");
const p2 = document.getElementById("p2");
let position = p1.compareDocumentPosition(p2);

Essayez-le vous-même

Syntaxe

node.compareDocumentPosition(node)

Paramètre

Paramètre Description
Node Obligatoire. Le nœud à comparer avec le nœud courant.

Valeur de retour

Type Description
Numérique La position de comparaison des deux nœuds.
Valeur Signification
1 Les nœuds n'appartiennent pas au même document.
2 Le premier nœud est situé après le deuxième nœud.
4 Le premier nœud est situé avant le deuxième nœud.
8 Le premier nœud est situé à l'intérieur du deuxième nœud.
16 Le deuxième nœud est situé à l'intérieur du premier nœud.
32 Le nœud est une propriété sur le même élément.

Compatibilité du navigateur

element.compareDocumentPosition() C'est une caractéristique du DOM Level 1 (1998).

Tous les navigateurs le supportent pleinement :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support 9-11 Support Support Support Support