Méthode HTML DOM compareDocumentPosition()
Exemple
Découvrez où un paragraphe est positionné par rapport à un autre paragraphe :
var p1 = document.getElementById("p1");
var p2 = document.getElementById("p2");
var x = p1.compareDocumentPosition(p2);
Définition et utilisation
La méthode compareDocumentPosition() compare deux nœuds et renvoie un entier décrivant leur position dans le document.
Regardez l'exemple ci-dessus. Les valeurs de retour possibles spécifieraient :
1 : Aucune relation, les deux nœuds n'appartiennent pas au même document.
2 : Le premier nœud (p1) est positionné 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 positionné à l'intérieur du deuxième nœud (p2).
16 : Le deuxième nœud (p2) est positionné à l'intérieur du premier nœud (p1).
32 : Aucune relation, ou les deux nœuds sont deux attributs sur le même élément.
Remarque : La valeur de retour peut également être une combinaison de valeurs. C'est-à-dire que la valeur de retour 20 signifie que p2 est à l'intérieur de p1 (16) ET que p1 est positionné avant p2 (4).
Prise en charge du navigateur
Les nombres dans le tableau indiquent la première version du navigateur qui prend entièrement en charge la méthode.
Method | |||||
---|---|---|---|---|---|
compareDocumentPosition() | Yes | 9.0 | Yes | Yes | Yes |
Syntaxe
node.compareDocumentPosition(node)
Valeurs des paramètres
Parameter | Type | Description |
---|---|---|
node | Node object | Required. Specifies the node to compare with the current node |
Détails techniques
Valeur de retour : | Un nombre, représentant l'endroit où deux nœuds sont positionnés l'un par rapport à l'autre.
Valeurs de retour possibles : 1 ( Aucune relation, les deux nœuds n'appartiennent pas au même document ) 2 ( Le premier nœud (p1) est positionné 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 positionné à l'intérieur du deuxième nœud (p2) ) 16 ( Le deuxième nœud (p2) est positionné à l'intérieur du premier nœud (p1) ) 32 ( Aucune relation, ou les deux nœuds sont deux attributs sur le même élément ) |
---|---|
Version DOM | Objet de nœud principal de niveau 1 |