Dojo: The Definitive Guide

NodeList

A NodeList is a specialized subclass of Array that is expressly designed with some fantastic extensions for manipulating collections of DOM nodes with ease. One of the more seductive features of a NodeList is its ability to provide chaining via the dot operator, although many specialized capabilities such as mapping, filtering, and looking up the index of a node exist as well.

Table 5-2 provides an overview of the NodeList methods available. These methods are named according to the very same convention as Base's Array functions. The only caveats are that they return NodeLists instead of Arrays.

Tip

For a review of the fundamentals involving the following Array manipulations, see the section "Array Processing" in Chapter 2.

Table 5-2. NodeList methods

Name	Comment
[a]
indexOf(/*DOMNode*/n)	Returns the first location of an item in the NodeList.
lastIndexOf(/*DOMNode*/n)	Returns the last location of an item in the NodeList.
every(/*Function*/f)	Returns true if the function returns true for every item in the NodeList.
some(/*Function*/f)	Returns true if the function returns true for at least one item in the NodeList.
forEach(/*Function*/f)	Runs each item through a function and returns the original NodeList.
map(/*Function*/f)	Runs each item through a function and returns the results as a NodeList.
filter(/*Function*/f)	Runs each item through a NodeList, returning only the items that meet the function criteria, or applies CSS query filtering to the list of nodes.
concat(/*Any*/item, ...)	Returns a ...