Método HTML DOM compareDocumentPosition()
Exemplo
Descubra onde um parágrafo está posicionado em comparação com outro parágrafo:
var p1 = document.getElementById("p1");
var p2 = document.getElementById("p2");
var x = p1.compareDocumentPosition(p2);
Definição e uso
O método compareDocumentPosition() compara dois nós e retorna um inteiro descrevendo onde eles estão posicionados no documento.
Veja o exemplo acima. Os possíveis valores de retorno especificariam:
1: Sem relacionamento, os dois nós não pertencem ao mesmo documento.
2: O primeiro nó (p1) é posicionado após o segundo nó (p2).
4: O primeiro nó (p1) é posicionado antes do segundo nó (p2).
8: O primeiro nó (p1) está posicionado dentro do segundo nó (p2).
16: O segundo nó (p2) está posicionado dentro do primeiro nó (p1).
32: Sem relacionamento, ou os dois nós são dois atributos no mesmo elemento.
Nota: O valor de retorno também pode ser uma combinação de valores. Ou seja, o valor de retorno 20 significa que p2 está dentro de p1 (16) E p1 está posicionado antes de p2 (4).
Suporte ao navegador
Os números na tabela especificam a primeira versão do navegador que oferece suporte total ao método.
Method | |||||
---|---|---|---|---|---|
compareDocumentPosition() | Yes | 9.0 | Yes | Yes | Yes |
Sintaxe
node.compareDocumentPosition(node)
Valores de parâmetro
Parameter | Type | Description |
---|---|---|
node | Node object | Required. Specifies the node to compare with the current node |
Detalhes técnicos
Valor de retorno: | Um Número, representando onde dois nós estão posicionados em comparação um com o outro.
Valores de retorno possíveis: 1 ( Sem relacionamento, os dois nós não pertencem ao mesmo documento ) 2 ( O primeiro nó (p1) é posicionado após o segundo nó (p2) ) 4 ( O primeiro nó (p1) está posicionado antes do segundo nó (p2) ) 8 ( O primeiro nó (p1) está posicionado dentro do segundo nó (p2) ) 16 ( O segundo nó (p2) está posicionado dentro do primeiro nó (p1) ) 32 ( Sem relacionamento, ou os dois nós são dois atributos no mesmo elemento ) |
---|---|
Versão DOM | Objeto de nó de nível 1 principal |