Interface HTMLCollection
public interface HTMLCollection
An
HTMLCollection is a list of nodes. An individual node may
be accessed by either ordinal index or the node'sname or
id attributes. Note: Collections in the HTML DOM are assumed
to be live meaning that they are automatically updated when the
underlying document is changed.
See also the Document Object Model (DOM) Level 2 Specification.
- Since:
- 1.4, DOM Level 2
-
Method Summary
-
Method Details
-
getLength
int getLength()This attribute specifies the length or size of the list. -
item
This method retrieves a node specified by ordinal index. Nodes are numbered in tree order (depth-first traversal order).- Parameters:
index- The index of the node to be fetched. The index origin is 0.- Returns:
- The
Nodeat the corresponding position upon success. A value ofnullis returned if the index is out of range.
-
namedItem
This method retrieves aNodeusing a name. It first searches for aNodewith a matchingidattribute. If it doesn't find one, it then searches for aNodewith a matchingnameattribute, but only on those elements that are allowed a name attribute.- Parameters:
name- The name of theNodeto be fetched.- Returns:
- The
Nodewith anameoridattribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull.
-