Interface HTMLSelectElement

All Superinterfaces:
Element, HTMLElement, Node
All Known Implementing Classes:
HTMLSelectElementImpl

public interface HTMLSelectElement extends HTMLElement
The select element allows the selection of an option. The contained options can be directly accessed through the select element as a collection. See the SELECT element definition in HTML 4.01.

See also the Document Object Model (DOM) Level 2 HTML Specification.

  • Method Details

    • getType

      String getType()
      The type of this form control. This is the string "select-multiple" when the multiple attribute is true and the string "select-one" when false.
    • getSelectedIndex

      int getSelectedIndex()
      The ordinal index of the selected option, starting from 0. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.
    • setSelectedIndex

      void setSelectedIndex(int selectedIndex)
      The ordinal index of the selected option, starting from 0. The value -1 is returned if no element is selected. If multiple options are selected, the index of the first selected option is returned.
    • getValue

      String getValue()
      The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.
    • setValue

      void setValue(String value)
      The current form control value (i.e. the value of the currently selected option), if multiple options are selected this is the value of the first selected option.
    • getLength

      int getLength()
      The number of options in this SELECT.
    • setLength

      void setLength(int length) throws DOMException
      The number of options in this SELECT.
      Throws:
      DOMException - NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.
    • getForm

      HTMLFormElement getForm()
      Returns the FORM element containing this control. Returns null if this control is not within the context of a form.
    • getOptions

      HTMLOptionsCollection getOptions()
      The collection of OPTION elements contained by this element.
    • getDisabled

      boolean getDisabled()
      The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.
    • setDisabled

      void setDisabled(boolean disabled)
      The control is unavailable in this context. See the disabled attribute definition in HTML 4.01.
    • getMultiple

      boolean getMultiple()
      If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01.
    • setMultiple

      void setMultiple(boolean multiple)
      If true, multiple OPTION elements may be selected in this SELECT. See the multiple attribute definition in HTML 4.01.
    • getName

      String getName()
      Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01.
    • setName

      void setName(String name)
      Form control or object name when submitted with a form. See the name attribute definition in HTML 4.01.
    • getSize

      int getSize()
      Number of visible rows. See the size attribute definition in HTML 4.01.
    • setSize

      void setSize(int size)
      Number of visible rows. See the size attribute definition in HTML 4.01.
    • getTabIndex

      int getTabIndex()
      Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01.
    • setTabIndex

      void setTabIndex(int tabIndex)
      Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.01.
    • add

      void add(HTMLElement element, HTMLElement before) throws DOMException
      Add a new element to the collection of OPTION elements for this SELECT. This method is the equivalent of the appendChild method of the Node interface if the before parameter is null. It is equivalent to the insertBefore method on the parent of before in all other cases. This method may have no effect if the new element is not an OPTION or an OPTGROUP.
      Parameters:
      element - The element to add.
      before - The element to insert before, or null for the tail of the list.
      Throws:
      DOMException - NOT_FOUND_ERR: Raised if before is not a descendant of the SELECT element.
    • remove

      void remove(int index)
      Remove an element from the collection of OPTION elements for this SELECT. Does nothing if no element has the given index.
      Parameters:
      index - The index of the item to remove, starting from 0.
    • blur

      void blur()
      Removes keyboard focus from this element.
    • focus

      void focus()
      Gives keyboard focus to this element.