TreeWalker.nextNode( ) |
return the next node that is not filtered out |
Availability DOM Level 2 Traversal
Synopsis Node nextNode( );
Returns The node that follows the current node in the document source and is not filtered out, or null if there is none.
Description This method sets currentNode to the next node (in document source order) that is not filtered out and returns that node. If there is no such node, or if the search for the next node takes the TreeWalker outside of the root subtree, currentNode remains unchanged and the method returns null. Note that this method "flattens" the document tree structure and returns nodes in the order in which they appear in the document source. Calling nextNode( ) may cause the current node to move down, sideways, or up the document tree. This type of flattening traversal can also be performed with NodeIterator.nextNode( ).
|