Méthode compareDocumentPosition()du DOM HTML

元素对象参考手册Objet Element

Exemples

Comparez la position dans le document du nœud actuel avec le nœud spécifié :

var p1=document.getElementById("p1"); var p2=document.getElementById("p2"); p1.compareDocumentPosition(p2);

Résultat de sortie :

4

Essayez-le vous-même »

Définition et utilisation

compareDocumentPosition()La méthode compare la position dans le document du nœud actuel avec le nœud spécifié dans l'ordre du document.

D'après l'exemple ci-dessus, la valeur de retour peut être :

1 : Aucune relation, les deux nœuds n'appartiennent pas au même document.

2 : Le premier nœud (P1) est situé après le deuxième nœud (P2).

4 : Le premier nœud (P1) est positionné avant le deuxième nœud (P2).

8 : Le premier nœud (P1) est situé à l'intérieur du deuxième nœud (P2).

16 : Le deuxième nœud (P2) est situé à l'intérieur du premier nœud (P1).

32 : Aucune relation, ou les deux nœuds sont deux attributs du même élément.

Remarque :La valeur de retour peut être une combinaison de valeurs. Par exemple, une valeur de retour de 20 signifie que p2 est à l'intérieur de p1 (16) et que p1 est avant p2 (4).


Prise en charge des navigateurs

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Tous les principaux navigateurs prennent en charge la méthode compareDocumentPosition()

Remarque :Internet Explorer 8 et les versions IE antérieures ne prennent pas en charge cette méthode.


Syntaxe

node.compareDocumentPosition(node)

Parameters

Paramètre Type Description
nœud Objet Node Obligatoire. Le nœud spécifié que vous voulez comparer.

Valeur de retour

Type Description
Number La position dans le document du nœud actuel par rapport au nœud spécifié

Valeurs de retour possibles :

D'après l'exemple ci-dessus, la valeur de retour peut être :

1 : Aucune relation, les deux nœuds n'appartiennent pas au même document.

2 : Le premier nœud (P1) est situé après le deuxième nœud (P2).

4 : Le premier nœud (P1) est positionné avant le deuxième nœud (P2).

8 : Le premier nœud (P1) est situé à l'intérieur du deuxième nœud (P2).

16 : Le deuxième nœud (P2) est situé à l'intérieur du premier nœud (P1).

32 : Aucune relation, ou les deux nœuds sont deux attributs du même élément.

Détails techniques

Version DOM Objet Node de niveau 1 du cœur


元素对象参考手册Objet Element

Autres extensions