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	2	속성 Attr (en-US) 노드들을 보여준다. Attr (en-US)노드가 루트인 TreeWalker를 생성할 때에만 의미가 있다. 이 경우, 그 속성 노드가 그 반복 또는 순회에 첫 위치로 나타남을 의미한다. 속성은 결코 다른 노드의 자식이 아니기 때문에 도큐먼트 트리를 순회할 때는 나타나지 않는다.
NodeFilter.SHOW_CDATA_SECTION	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	32	Entity 노드들을 보여준다. Entity 노드를 루트로 하여 TreeWalker를 생성할 때만 의미가 있다; 이 경우, 그 Entity 노드가 그 순회의 첫 위치에 나타남을 의미한다. 엔티티들은 도큐먼트 트리의 일부가 아니기 때문에 도큐먼트 트리를 순회할 때 나타나지 않는다.
NodeFilter.SHOW_ENTITY_REFERENCE	16	EntityReference 노드들을 보여준다.
NodeFilter.SHOW_NOTATION	2048	Notation (en-US) 노드들을 보여준다. Notation (en-US) 노드를 루트로 하여 TreeWalker를 생성할 때만 의미가 있다; 이 경우, 그 Notation (en-US) 노드가 순회의 첫 위치에 나타남을 의미한다, 그들은 도큐먼트 트리를 순회할 때 나타나지 않는다.
NodeFilter.SHOW_PROCESSING_INSTRUCTION	64	ProcessingInstruction (en-US) 노드들을 보여준다.
NodeFilter.SHOW_TEXT	4	Text 노드들을 보여준다.

TreeWalker.filter (en-US) Read only

의미있는 노드들을 선택하기 위해 사용하는 NodeFilter를 반환한다.

TreeWalker.expandEntityReferences (en-US) Read only

한 EntityReference를 버릴 때 그 것의 전체 서브트리도 같이 버려야함을 표시하는 Boolean이다.

TreeWalker.currentNode

TreeWalker가 현재 가리키고 있는 Node이다.

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

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을 반환하고 현재 노드는 바뀌지 않는다.

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