HTML DOM CompareDocumentPosition() Metoda
Przykład
Dowiedz się, gdzie znajduje się jeden akapit w porównaniu z innym akapitem:
var p1 = document.getElementById("p1");
var p2 = document.getElementById("p2");
var x = p1.compareDocumentPosition(p2);
Definicja i użycie
Metoda CompareDocumentPosition() porównuje dwa węzły i zwraca liczbę całkowitą opisującą ich położenie w dokumencie.
Spójrz na powyższy przykład. Możliwe zwracane wartości określałyby:
1: Brak relacji, dwa węzły nie należą do tego samego dokumentu.
2: Pierwszy węzeł (p1) jest umieszczony za drugim węzłem (p2).
4: Pierwszy węzeł (p1) jest umieszczony przed drugim węzłem (p2).
8: Pierwszy węzeł (p1) znajduje się wewnątrz drugiego węzła (p2).
16: Drugi węzeł (p2) znajduje się wewnątrz pierwszego węzła (p1).
32: Brak relacji lub dwa węzły to dwa atrybuty tego samego elementu.
Uwaga: Zwrócona wartość może być również kombinacją wartości. Tzn. zwracana wartość 20 oznacza, że p2 jest wewnątrz p1 (16) ORAZ p1 jest umieszczone przed p2 (4).
Obsługa przeglądarki
Liczby w tabeli określają pierwszą wersję przeglądarki, która w pełni obsługuje tę metodę.
| Method | |||||
|---|---|---|---|---|---|
| compareDocumentPosition() | Yes | 9.0 | Yes | Yes | Yes |
Składnia
node.compareDocumentPosition(node)
Wartości parametrów
| Parameter | Type | Description |
|---|---|---|
| node | Node object | Required. Specifies the node to compare with the current node |
Szczegóły techniczne
| Wartość zwrotu: | Liczba reprezentująca położenie dwóch węzłów w porównaniu ze sobą.
Możliwe zwracane wartości: 1 ( Brak relacji, dwa węzły nie należą do tego samego dokumentu ) 2 ( Pierwszy węzeł (p1) znajduje się za drugim węzłem (p2) ) 4 ( Pierwszy węzeł (p1) znajduje się przed drugim węzłem (p2) ) 8 ( Pierwszy węzeł (p1) znajduje się wewnątrz drugiego węzła (p2) ) 16 ( Drugi węzeł (p2) znajduje się wewnątrz pierwszego węzła (p1) ) 32 ( Brak relacji lub dwa węzły to dwa atrybuty tego samego elementu ) |
|---|---|
| Wersja DOM | Obiekt węzła poziomu podstawowego |