DocumentTraversal は、ドキュメントオーダー (深さは第一に、文書のテキスト表現において開始タグが出現する順序と同じであるトラバーサルを前序列化する) 内のノードとその子をトラバースするためのイテレータとツリーウォーカーを生成するメソッドで構成される。Traversal をサポートする DOM において、 DocumentTraversal は Document インターフェイスを実装するオブジェクトと同じオブジェクトによって実装される。
createNodeIterator( root, whatToShow, filter, entityReferenceExpansion )指定されたノードをルートとする下位ツリーを横切る新規 NodeIterator を生成する。
whatToShow フラグとフィルタがあってもこの位置の設定時には考慮されない。 root はけして null にはならない。SHOW_ 値の集合については NodeFilter の説明を参照。OR で結合できる。TreeWalker と共に使用される NodeFilter、フィルタを使用しないならば null 。NodeIterator 型。新規に生成された NodeIterator 。
root が null である場合に発生。createTreeWalker( root, whatToShow, filter, entityReferenceExpansion )指定されたノードをルートとする下位ツリーを横切る新規 TreeWalker を生成する
TreeWalker の root として提出するノード。この値が設定されているとき、 whatToShow フラグと NodeFilter は考慮されない; どんなノード型も root として受け入れられる。 TreeWalker の currentNode は、それが可視であるかどうかに関係なくこのノードで初期化される。 root は、 parentNode や nextNode のような、文書構造内部を見渡すようなトラバーサルメソッドの停止点として機能する。 root は null であってはならない。SHOW_ 値の集合については NodeFilter の説明を参照。OR で結合できる。TreeWalker と共に使用する NodeFilter 、フィルタを使用しないならば null 。EntityReference ノードの内容は論理ビュー内部に存在しない。TreeWalker 型。新規に生成された TreeWalker 。
root が null である場合に発生。
// Introduced in DOM Level 2:
interface DocumentTraversal {
NodeIterator createNodeIterator(in Node root,
in unsigned long whatToShow,
in NodeFilter filter,
in boolean entityReferenceExpansion)
raises(DOMException);
TreeWalker createTreeWalker(in Node root,
in unsigned long whatToShow,
in NodeFilter filter,
in boolean entityReferenceExpansion)
raises(DOMException);
};