표준은 아니지만 웹개발자를 위하여 거의 표준처럼 사용된다.
현재 노드를 기준으로 지정된 노드의 위치를 문서 내 다른 노드와 비교하여 기본적으로 정의된 값을 반환한다.
지정된 노드의 위치를 다음과 같이 정수로 반환한다.
Return | Constants | Description |
---|---|---|
1 | Node.DOCUMENT_POSITION_DISCONNECTED | 두 노드는 모두 다른 문서에 있거나 동일한 문서의 다른 트리에 있음을 나타낸다. |
2 | Node.DOCUMENT_POSITION_PRECEDING | 지정된 노드는 현재 노드와 함께 포함하는 트리에서 현재 노드의 앞에 있음을 나타낸다. |
4 | Node.DOCUMENT_POSITION_FOLLOWING | 지정된 노드는 현재 노드와 함께 포함하는 트리에서 현재 노드의 뒤에 있음을 나타낸다. |
8 | Node.DOCUMENT_POSITION_CONTAINS | 지정된 노드는 현재 노드의 조상임을 나타낸다. |
16 | Node.DOCUMENT_POSITION_CONTAINED_BY | 지정된 노드는 현재 노드의 자손임을 나타낸다. |
32 | Node.DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC | 결과는 임의 또는구현별 동작에 따라 달라지며 이식성이 보장되지 않음을 나타낸다. |
조건에 부합되는 것에 따라 각 반환될 값의 합산을 반환한다. 예를 들어서 지정된 노드가 현재 노드의 부모 노드인 경우에는 원래 반환값은 8
이고 지정된 노드는 현재 노드보다 앞에 있으므로 원래 반환값은 2
이다. 따라서 두 조건이 충족되므로 최종 반환값은 합산의 결과인 10
이다.
node.compareDocumentPosition(other)
비교할 다른 노드를 지정한다.
지정된 노드와의 관계를 나타내는 비트 마스크(bitmask)를 반환한다.