-
public interface HTMLCollection
AnHTMLCollection
is a list of nodes. An individual node may be accessed by either ordinal index or the node'sname
orid
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
All Methods Instance Methods Abstract Methods Modifier and Type Method Description int
getLength()
This attribute specifies the length or size of the list.Node
item(int index)
This method retrieves a node specified by ordinal index.Node
namedItem(String name)
This method retrieves aNode
using a name.
-
-
-
Method Detail
-
getLength
int getLength()
This attribute specifies the length or size of the list.
-
item
Node item(int index)
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
Node namedItem(String name)
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
.
-
-