Méthode compareDocumentPosition()du DOM HTML
Exemples
Comparez la position dans le document du nœud actuel avec le nœud spécifié :
Résultat de sortie :
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
![]()
![]()
![]()
![]()
![]()
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
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 |
|---|
Autres extensions
Objet Element