Node.compareDocumentPosition()

La méthode Node.compareDocumentPosition()compare la position du noeud courant par rapport à un autre noeud dans tout autre document.

La valeur retournée est un masque de bits avec les valeurs suivantes :

Nom Valeur
DOCUMENT_POSITION_DISCONNECTED 1
DOCUMENT_POSITION_PRECEDING 2
DOCUMENT_POSITION_FOLLOWING 4
DOCUMENT_POSITION_CONTAINS 8
DOCUMENT_POSITION_CONTAINED_BY 16
DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC 32

Syntaxe

node.compareDocumentPosition( otherNode )

Exemple

var head = document.getElementsByTagName('head').item(0);

if (head.compareDocumentPosition(document.body) & Node.DOCUMENT_POSITION_FOLLOWING) {
  console.log("well-formed document");
} else {
  console.log("<head> is not before <body>");
}

Note : Parce que le résultat renvoyé par compareDocumentPosition est un masque de bits, des opérateurs binaires doivent être utilisés pour des résultats significatifs.

Note : La première instruction utilise l' item(0) de la méthode NodeList , qui est l'équivalent de getElementsByTagName('head')[0].

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'Node.compareDocumentPosition()' dans cette spécification.
Standard évolutif  
Document Object Model (DOM) Level 3 Core Specification
La définition de 'Node.compareDocumentPosition()' dans cette spécification.
Obsolete Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi