Package org.w3c.dom.html
Interface HTMLSelectElement
- All Superinterfaces:
Element
,HTMLElement
,Node
The select element allows the selection of an option. The containedoptions
can be directly accessed through the select element as acollection. See
the SELECT element definition in HTML 4.0.
-
Field Summary
Fields inherited from 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 TypeMethodDescriptionvoid
add
(HTMLElement element, HTMLElement before) Add a new element to the collection ofOPTION
elementsfor thisSELECT
.void
blur()
Removes keyboard focus from this element.void
focus()
Gives keyboard focus to this element.boolean
The control is unavailable in this context.getForm()
Returns theFORM
element containing this control.Returns null if this control is not within the context of a form.int
The number of options in thisSELECT
.boolean
If true, multipleOPTION
elements may be selected in thisSELECT
.getName()
Form control or object name when submitted with a form.The collection ofOPTION
elements contained by this element.int
The ordinal index of the selected option.int
getSize()
Number of visible rows.int
Index that represents the element's position in the tabbing order.getType()
The type of control created.getValue()
The current form control value.void
remove
(int index) Remove an element from the collection ofOPTION
elementsfor thisSELECT
.void
setDisabled
(boolean disabled) void
setMultiple
(boolean multiple) void
void
setSelectedIndex
(int selectedIndex) void
setSize
(int size) void
setTabIndex
(int tabIndex) void
Methods inherited from interface org.w3c.dom.Element
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS, setIdAttribute, setIdAttributeNode, setIdAttributeNS
Methods inherited from interface org.w3c.dom.html.HTMLElement
getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle
Methods inherited from 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 control created. -
getSelectedIndex
int getSelectedIndex()The ordinal index of the selected option. The value -1 is returned ifno element is selected. If multiple options are selected, the index ofthe 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 theFORM
element containing this control.Returns null if this control is not within the context of a form. -
getOptions
HTMLCollection getOptions()The collection ofOPTION
elements 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, multipleOPTION
elements 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 ofOPTION
elementsfor thisSELECT
.- Parameters:
element
- The element to add.before
- The element to insert before, or NULL for the head of the list.
-
remove
void remove(int index) Remove an element from the collection ofOPTION
elementsfor thisSELECT
. Does nothing if no element has the givenindex.- Parameters:
index
- The index of the item to remove.
-
blur
void blur()Removes keyboard focus from this element. -
focus
void focus()Gives keyboard focus to this element.
-