Interface HTMLSelectElement
- All Superinterfaces:
Element,HTMLElement,Node
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.0.
See also the Document Object Model (DOM) Level 2 Specification.
- Since:
- 1.4, DOM Level 2
-
Field Summary
Fields declared in interface org.w3c.dom.Node
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE -
Method Summary
Modifier and TypeMethodDescriptionvoidadd(HTMLElement element, HTMLElement before) Add a new element to the collection ofOPTIONelements for thisSELECT.voidblur()Removes keyboard focus from this element.voidfocus()Gives keyboard focus to this element.booleanThe control is unavailable in this context.getForm()Returns theFORMelement containing this control.intThe number of options in thisSELECT.booleanIf true, multipleOPTIONelements may be selected in thisSELECT.getName()Form control or object name when submitted with a form.The collection ofOPTIONelements contained by this element.intThe ordinal index of the selected option, starting from 0.intgetSize()Number of visible rows.intIndex that represents the element's position in the tabbing order.getType()The type of this form control.getValue()The current form control value.voidremove(int index) Remove an element from the collection ofOPTIONelements for thisSELECT.voidsetDisabled(boolean disabled) voidsetMultiple(boolean multiple) voidvoidsetSelectedIndex(int selectedIndex) voidsetSize(int size) voidsetTabIndex(int tabIndex) voidMethods declared in interface org.w3c.dom.Element
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNSMethods declared in interface org.w3c.dom.html.HTMLElement
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitleMethods declared in interface org.w3c.dom.Node
appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData
-
Method Details
-
getType
String getType()The type of this form control. This is the string "select-multiple" when the multiple attribute istrueand the string "select-one" whenfalse. -
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) -
getValue
String getValue()The current form control value. -
setValue
-
getLength
int getLength()The number of options in thisSELECT. -
getForm
HTMLFormElement getForm()Returns theFORMelement containing this control. Returnsnullif this control is not within the context of a form. -
getOptions
HTMLCollection getOptions()The collection ofOPTIONelements contained by this element. -
getDisabled
boolean getDisabled()The control is unavailable in this context. See the disabled attribute definition in HTML 4.0. -
setDisabled
void setDisabled(boolean disabled) -
getMultiple
boolean getMultiple()If true, multipleOPTIONelements may be selected in thisSELECT. See the multiple attribute definition in HTML 4.0. -
setMultiple
void setMultiple(boolean multiple) -
getName
String getName()Form control or object name when submitted with a form. See the name attribute definition in HTML 4.0. -
setName
-
getSize
int getSize()Number of visible rows. See the size attribute definition in HTML 4.0. -
setSize
void setSize(int size) -
getTabIndex
int getTabIndex()Index that represents the element's position in the tabbing order. See the tabindex attribute definition in HTML 4.0. -
setTabIndex
void setTabIndex(int tabIndex) -
add
Add a new element to the collection ofOPTIONelements for thisSELECT. This method is the equivalent of theappendChildmethod of theNodeinterface if thebeforeparameter isnull. It is equivalent to theinsertBeforemethod on the parent ofbeforein all other cases.- Parameters:
element- The element to add.before- The element to insert before, ornullfor the tail of the list.- Throws:
DOMException- NOT_FOUND_ERR: Raised ifbeforeis not a descendant of theSELECTelement.
-
remove
void remove(int index) Remove an element from the collection ofOPTIONelements for thisSELECT. 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.
-