public interface HTMLCollection
HTMLCollection
is a list of nodes. An individual node may
be accessed by either ordinal index or the node's name
or
id
attributes. 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 HTML Specification.
int getLength()
Node item(int index)
index
- The index of the node to be fetched. The index origin is
0
.Node
at the corresponding position upon
success. A value of null
is returned if the index is
out of range.Node namedItem(String name)
Node
using a name. With [HTML 4.01]
documents, it first searches for a Node
with a matching
id
attribute. If it doesn't find one, it then searches
for a Node
with a matching name
attribute,
but only on those elements that are allowed a name attribute. With [XHTML 1.0]
documents, this method only searches for Nodes
with a
matching id
attribute. This method is case insensitive
in HTML documents and case sensitive in XHTML documents.name
- The name of the Node
to be fetched.Node
with a name
or
id
attribute whose value corresponds to the specified
string. Upon failure (e.g., no node with this name exists), returns
null
.