Package org.w3c.dom.html2

Interface HTMLOptionsCollection

  • All Known Implementing Classes:
    HTMLOptionsCollectionImpl
    public interface HTMLOptionsCollection
    An 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

      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 a Node using a name.
      void setLength​(int length)
      This attribute specifies the length or size of the list.

    • Method Detail

      • getLength

        int getLength()
        This attribute specifies the length or size of the list.

      • setLength

        void setLength​(int length)
        throws org.w3c.dom.DOMException
        This attribute specifies the length or size of the list.
        Throws:
        org.w3c.dom.DOMException - NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.

      • 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 is 0.
        Returns:
        The Node at the corresponding position upon success. A value of null is returned if the index is out of range.

      • namedItem

        org.w3c.dom.Node namedItem​(java.lang.String name)
        This method retrieves a 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.