Método XML DOM compareDocumentPosition()
❮ Objeto de nó
Exemplo
O fragmento de código a seguir carrega " books.xml " em xmlDoc e compara o posicionamento de dois nós (o primeiro e o terceiro elemento <book>) na hierarquia DOM:
var xhttp = new XMLHttpRequest();
xhttp.onreadystatechange = function() {
if (this.readyState == 4 && this.status == 200) {
myFunction(this);
}
};
xhttp.open("GET", "books.xml", true);
xhttp.send();
function myFunction(xml) {
var xmlDoc = xml.responseXML;
var x =
xmlDoc.getElementsByTagName('book')[0];
var y =
xmlDoc.getElementsByTagName('book')[2];
document.getElementById("demo").innerHTML =
x.compareDocumentPosition(y);
}
A saída do código acima será:
4
A maioria dos navegadores tratará espaços em branco vazios ou novas linhas como nós de texto, o IE 9 e versões anteriores não. Portanto, no exemplo acima, a maioria dos navegadores produzirá 4, enquanto o IE 9 e versões anteriores produzirão 2.
Definição e uso
O método compareDocumentPosition() compara o posicionamento de dois nós na hierarquia DOM (documento).
Suporte ao navegador
O método compareDocumentPosition() é suportado em todos os principais navegadores.
Observação: o Internet Explorer 9 e versões anteriores não oferecem suporte a esse método.
Sintaxe
nodeObject.compareDocumentPosition(node)
Parâmetros
Parameter | Type | Description |
---|---|---|
node | Node object | Required. Specifies the node to compare with the current node |
Valor de retorno
Type | Description |
---|---|
Number | A Number representing where the two nodes are positioned compared to each other. The possible return values
are:
1 - No relationship, the two nodes do not belong to the same document. 2 - The specified node precedes the current node. 4 - The specified node follows the current node. 8 - The specified node contains the current node. 16 - The specified node is contained by the current node. 32 - The specified and the current node have no common container node or the two nodes are different attributes of the same node. Note: The return value could also be a combination of values. E.g. a return value of 20 means that the specified node is contained by the current node (16) AND the specified node follows the current node (4). |
Detalhes técnicos
Versão DOM | Objeto de nó principal de nível 3 |
---|
❮ Objeto de nó