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
Node
at the corresponding position upon success. A value ofnull
is returned if the index is out of range.
-
namedItem
This method retrieves aNode
using a name. It first searches for aNode
with a matchingid
attribute. If it doesn't find one, it then searches for aNode
with a matchingname
attribute, but only on those elements that are allowed a name attribute.- Parameters:
name
- The name of theNode
to be fetched.- Returns:
- The
Node
with aname
orid
attribute whose value corresponds to the specified string. Upon failure (e.g., no node with this name exists), returnsnull
.
-