TreeWalker

TreeWalker 오브젝트는 도큐먼트 서브트리의 노드들과 그 안에서의 위치를 나타낸다.

TreeWalker 는 Document.createTreeWalker() 메소드로 생성할 수 있다.

속성

이 인터페이스는 어떤 프라퍼티도 상속하지 않는다.

TreeWalker.root (en-US) Read only
- : TreeWalker 를 생성할 때 지정한 루트 노드를 나타대는 Node를 반환한다.

TreeWalker.whatToShow (en-US) Read only

: 제공해야할 `Node` 유형을 기술하는 `unsigned long` 비트마스크를 반환한다. 일치하지 않는 노드들은 건너뛰지만 관련된 경우 그 자식들을 포함할 수 있다. 가능한 값들은:	상수	숫자 값
`NodeFilter.SHOW_ALL`	`-1` ( `unsigned long의 최대 값`)	모든 노드를 보여준다.
`NodeFilter.SHOW_ATTRIBUTE` Deprecated	`2`	속성 `Attr` 노드들을 보여준다. `Attr`노드가 루트인 `TreeWalker`를 생성할 때에만 의미가 있다. 이 경우, 그 속성 노드가 그 반복 또는 순회에 첫 위치로 나타남을 의미한다. 속성은 결코 다른 노드의 자식이 아니기 때문에 도큐먼트 트리를 순회할 때는 나타나지 않는다.
`NodeFilter.SHOW_CDATA_SECTION` Deprecated	`8`	`CDATASection` (en-US) 노드들을 보여준다.
`NodeFilter.SHOW_COMMENT`	`128`	`Comment` 노드들을 보여준다.
`NodeFilter.SHOW_DOCUMENT`	`256`	`Document` 노드들을 보여준다.
`NodeFilter.SHOW_DOCUMENT_FRAGMENT`	`1024`	`DocumentFragment` 노드들을 보여준다.
`NodeFilter.SHOW_DOCUMENT_TYPE`	`512`	`DocumentType` 노드들을 보여준다.
`NodeFilter.SHOW_ELEMENT`	`1`	`Element` 노드들을 보여준다.
`NodeFilter.SHOW_ENTITY` Deprecated	`32`	`Entity` 노드들을 보여준다. `Entity` 노드를 루트로 하여 `TreeWalker`를 생성할 때만 의미가 있다; 이 경우, 그 `Entity` 노드가 그 순회의 첫 위치에 나타남을 의미한다. 엔티티들은 도큐먼트 트리의 일부가 아니기 때문에 도큐먼트 트리를 순회할 때 나타나지 않는다.
`NodeFilter.SHOW_ENTITY_REFERENCE` Deprecated	`16`	`EntityReference` 노드들을 보여준다.
`NodeFilter.SHOW_NOTATION` Deprecated	`2048`	`Notation` 노드들을 보여준다. `Notation` 노드를 루트로 하여 `TreeWalker`를 생성할 때만 의미가 있다; 이 경우, 그 `Notation` 노드가 순회의 첫 위치에 나타남을 의미한다, 그들은 도큐먼트 트리를 순회할 때 나타나지 않는다.
`NodeFilter.SHOW_PROCESSING_INSTRUCTION`	`64`	`ProcessingInstruction` (en-US) 노드들을 보여준다.
`NodeFilter.SHOW_TEXT`	`4`	`Text` 노드들을 보여준다.

TreeWalker.filter (en-US) Read only
- : 의미있는 노드들을 선택하기 위해 사용하는 NodeFilter를 반환한다.
TreeWalker.expandEntityReferences Read only Deprecated
- : 한 EntityReference를 버릴 때 그 것의 전체 서브트리도 같이 버려야함을 표시하는 Boolean이다.
TreeWalker.currentNode
- : TreeWalker가 현재 가리키고 있는 Node이다.

메서드

이 인터페이스는 아무 메서드도 상속하지 않는다.

참고: TreeWalker는 보이는 DOM 노드만 고려한다는 것에주의하라.

TreeWalker.parentNode() (en-US): 현재 Node를 도큐먼트 순서의 첫번째 보이는 조상으로 이동하고 찾은 노드를 반환한다. 그런 노드가 없거나 오브젝트 생성시에 정의한 루트 노드보다 앞이면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.firstChild() (en-US): 현재 Node를 현재 노드의 첫번째 보이는 자식으로 이동하고 찾은 자식을 반환한다. 그런 자식이 없으면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.lastChild() (en-US): 현재 Node를 현재 노드의 마지막 보이는 자식으로 이동하고 찾은 자식을 반환한다. 그런 자식이 없으면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.previousSibling() (en-US): 현재 Node를 이전 형제로 이동하고 찾은 형제를 반환한다. 그런 노드가 없으면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.nextSibling() (en-US): 현재 Node를 다음 형제로 이동하고 찾은 형제를 반환한다. 그런 노드가 없으면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.previousNode() (en-US): 현재 Node를 도큐먼트 순서의 이전 보이는 노드로 이동하고 찾은 노드를 반환한다. 그런 노드가 없거나 오브젝트 생성시에 정의한 루트 노드보다 앞이면 null을 반환하고 현재 노드는 바뀌지 않는다.
TreeWalker.nextNode() (en-US): 현재 Node를 도큐먼트 순서의 다음 보이는 노드로 이동하고 찾은 노드를 반환한다. 그런 노드가 없거나 오브젝트 생성시에 정의한 루트 노드보다 앞이면 null을 반환하고 현재 노드는 바뀌지 않는다.

명세

Specification
DOM Standard # interface-treewalker

브라우저 호환성

BCD tables only load in the browser

같이 보기

생성 메소드: Document.createTreeWalker().
관련된 인터페이스: NodeFilter, NodeIterator (en-US).