Método HTML DOM Element compareDocumentPosition()

Definição e uso

compareDocumentPosition() O método compara dois nós e retorna um inteiro, descrevendo sua posição no documento:

Valor Significado
1 Os nós não pertencem ao mesmo documento.
2 O primeiro nó está depois do segundo nó.
4 O primeiro nó está antes do segundo nó.
8 O primeiro nó está dentro do segundo nó.
16 O segundo nó está dentro do primeiro nó.
32 O nó é um atributo do mesmo elemento.

Comentário

O retorno também pode ser uma combinação de valores.

O valor 20 indica que o segundo nó está dentro do primeiro nó (16) e o primeiro nó está antes do segundo nó (4).

Exemplo

"p1" em comparação com "p2":

const p1 = document.getElementById("p1");
const p2 = document.getElementById("p2");
let position = p1.compareDocumentPosition(p2);

Experimente você mesmo

Sintaxe

node.compareDocumentPosition(node)

Parâmetro

Parâmetro Descrição
Node Obrigatório. O nó a ser comparado com o nó atual.

Retorno

Tipo Descrição
Número A posição de comparação entre os dois nós.
Valor Significado
1 Os nós não pertencem ao mesmo documento.
2 O primeiro nó está depois do segundo nó.
4 O primeiro nó está antes do segundo nó.
8 O primeiro nó está dentro do segundo nó.
16 O segundo nó está dentro do primeiro nó.
32 O nó é um atributo do mesmo elemento.

Suporte do navegador

element.compareDocumentPosition() É uma característica do DOM Level 1 (1998).

Todos os navegadores suportam completamente:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Suporte 9-11 Suporte Suporte Suporte Suporte