Package org.w3c.dom.html2
Interface HTMLCollection
-
- All Known Implementing Classes:
ChildHTMLCollection
,DescendentHTMLCollection
,HTMLOptionsCollectionImpl
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. 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.
-
-
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.org.w3c.dom.Node
item(int index)
This method retrieves a node specified by ordinal index.org.w3c.dom.Node
namedItem(java.lang.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
org.w3c.dom.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 is0
.- Returns:
- The
Node
at the corresponding position upon success. A value ofnull
is returned if the index is out of range.
-
namedItem
org.w3c.dom.Node namedItem(java.lang.String name)
This method retrieves aNode
using a name. With [HTML 4.01] documents, 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. With [XHTML 1.0] documents, this method only searches forNodes
with a matchingid
attribute. This method is case insensitive in HTML documents and case sensitive in XHTML documents.- 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
.
-
-