org.w3c.dom.html2
public interface HTMLOptionsCollection
HTMLOptionsCollection
is a list of nodes representing HTML
option element. 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.
Since: DOM Level 2
Method Summary | |
---|---|
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 a Node using a name. |
void | setLength(int length)
This attribute specifies the length or size of the list. |
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 of null
is returned if the index is
out of range.
Node
using a name. 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. This method
is case insensitive in HTML documents and case sensitive in XHTML
documents.Parameters: name The name of the Node
to be fetched.
Returns: The 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
.
Throws: DOMException NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.