TreeWalker

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

TreeWalkerDocument.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 (en-US) 노드들을 보여준다. Attr (en-US)노드가 루트인 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

같이 보기