org.w3c.dom.html2
public interface HTMLSelectElement extends HTMLElement
See also the Document Object Model (DOM) Level 2 HTML Specification.
Method Summary | |
---|---|
void | add(HTMLElement element, HTMLElement before)
Add a new element to the collection of OPTION elements for
this SELECT . |
void | blur()
Removes keyboard focus from this element. |
void | focus()
Gives keyboard focus to this element. |
boolean | getDisabled()
The control is unavailable in this context. |
HTMLFormElement | getForm()
Returns the FORM element containing this control. |
int | getLength()
The number of options in this SELECT . |
boolean | getMultiple()
If true, multiple OPTION elements may be selected in this
SELECT . |
String | getName()
Form control or object name when submitted with a form. |
HTMLOptionsCollection | getOptions()
The collection of OPTION elements contained by this
element. |
int | getSelectedIndex()
The ordinal index of the selected option, starting from 0. |
int | getSize()
Number of visible rows. |
int | getTabIndex()
Index that represents the element's position in the tabbing order. |
String | getType()
The type of this form control. |
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. |
void | remove(int index)
Remove an element from the collection of OPTION elements
for this SELECT . |
void | setDisabled(boolean disabled)
The control is unavailable in this context. |
void | setLength(int length)
The number of options in this SELECT . |
void | setMultiple(boolean multiple)
If true, multiple OPTION elements may be selected in this
SELECT . |
void | setName(String name)
Form control or object name when submitted with a form. |
void | setSelectedIndex(int selectedIndex)
The ordinal index of the selected option, starting from 0. |
void | setSize(int size)
Number of visible rows. |
void | setTabIndex(int tabIndex)
Index that represents the element's position in the tabbing order. |
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. |
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.
FORM
element containing this control. Returns
null
if this control is not within the context of a
form.SELECT
.OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.OPTION
elements contained by this
element.true
and the string
"select-one" when false
.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.
SELECT
.Throws: DOMException NOT_SUPPORTED_ERR: if setting the length is not allowed by the implementation.
OPTION
elements may be selected in this
SELECT
. See the multiple attribute definition in HTML
4.01.