com.gargoylesoftware.htmlunit.javascript.host.html

Class HTMLSelectElement

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

com.gargoylesoftware.htmlunit.javascript.host.event.EventTarget

com.gargoylesoftware.htmlunit.javascript.host.dom.Node

com.gargoylesoftware.htmlunit.javascript.host.Element

com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

com.gargoylesoftware.htmlunit.javascript.host.html.FormField

com.gargoylesoftware.htmlunit.javascript.host.html.HTMLSelectElement

All Implemented Interfaces:

Serializable, Cloneable, net.sourceforge.htmlunit.corejs.javascript.ConstProperties, net.sourceforge.htmlunit.corejs.javascript.debug.DebuggableObject, net.sourceforge.htmlunit.corejs.javascript.Scriptable, net.sourceforge.htmlunit.corejs.javascript.SymbolScriptable

public class HTMLSelectElement
extends FormField

The JavaScript object for HtmlSelect.

Author:

Mike Bowler, David K. Taylor, Marc Guillemot, Chris Erskine, Ahmed Ashour, Ronald Brill, Carsten Steul

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

HTMLElement.ProxyDomNode

Nested classes/interfaces inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject.KeyComparator

Field Summary

Fields inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

BEHAVIOR_ID_CLIENT_CAPS, BEHAVIOR_ID_DOWNLOAD, BEHAVIOR_ID_HOMEPAGE

Fields inherited from class com.gargoylesoftware.htmlunit.javascript.host.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

Fields inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor and Description
HTMLSelectElement() Creates an instance.

Method Summary

Modifier and Type	Method and Description
void	add(HTMLOptionElement newOptionObject, Object beforeOptionObject) Adds a new item to the list (optionally) before the specified item.
Object	appendChild(Object childObject) Adds a DOM node to the node.
boolean	checkValidity() Checks whether the element has any constraints and whether it satisfies them.
Object	get(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start) Returns the specified indexed property.
AbstractList	getLabels() Returns the labels associated with the element.
int	getLength() Returns the value of the length property.
HTMLOptionsCollection	getOptions() Returns the value of the options property.
int	getSelectedIndex() Returns the value of the selectedIndex property.
int	getSize() Returns the size attribute.
String	getType() Returns the type of this input.
String	getValue() Returns the actual value of the selected Option.
void	initialize() Initialize the object.
Object	insertBeforeImpl(Object[] args) Add a DOM node as a child to this node before the referenced node.
boolean	isMultiple() Returns true if the multiple attribute is set.
boolean	isRequired() Returns the required property.
Object	item(int index) Gets the item at the specified index.
void	put(int index, net.sourceforge.htmlunit.corejs.javascript.Scriptable start, Object newValue) Sets the index property.
void	remove(int index) Removes option at the specified index.
void	setLength(int newLength) Removes options by reducing the length property.
void	setMultiple(boolean multiple) Sets or clears the multiple attribute.
void	setRequired(boolean required) Sets the required property.
void	setSelectedIndex(int index) Sets the value of the selectedIndex property.
void	setSize(String size) Sets the size attribute.
void	setValue(Object newValue) Selects the option with the specified value.

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.FormField

getForm, getName, isDisabled, setDisabled, setDomNode, setName

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

addBehavior, addComponentRequest, blur, clearAttributes, clearComponentRequest, click, compareVersions, contains, doComponentRequest, focus, getAccessKey, getAlign, getAttributeNode, getAvailHeight, getAvailWidth, getBoundingClientRect, getBufferDepth, getCh, getChildren, getChOff, getClassList, getClassName_js, getColorDepth, getComponentVersion, getContentEditable, getCpuClass, getCurrentStyle, getDataset, getDir, getDomNodeOrDie, getDomNodeOrNull, getElementsByClassName, getHeight, getId, getInnerHTML, getInnerText, getLang, getLanguage, getLocalName, getNodeName, getOffsetHeight, getOffsetLeft, getOffsetParent_js, getOffsetTop, getOffsetWidth, getOnabort, getOnactivate, getOnanimationend, getOnanimationiteration, getOnanimationstart, getOnauxclick, getOnbeforeactivate, getOnbeforecopy, getOnbeforecut, getOnbeforedeactivate, getOnbeforepaste, getOnblur, getOncancel, getOncanplay, getOncanplaythrough, getOnchange, getOnclick, getOnclose, getOncontextmenu, getOncopy, getOncuechange, getOncut, getOndblclick, getOndeactivate, getOndrag, getOndragend, getOndragenter, getOndragexit, getOndragleave, getOndragover, getOndragstart, getOndrop, getOndurationchange, getOnemptied, getOnended, getOnerror, getOnfocus, getOnfocusin, getOnfocusout, getOngotpointercapture, getOnhelp, getOninput, getOninvalid, getOnkeydown, getOnkeypress, getOnkeyup, getOnload, getOnloadeddata, getOnloadedmetadata, getOnloadend, getOnloadstart, getOnlostpointercapture, getOnmousedown, getOnmouseenter, getOnmouseleave, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnmousewheel, getOnmozfullscreenchange, getOnmozfullscreenerror, getOnmscontentzoom, getOnmsmanipulationstatechanged, getOnpaste, getOnpause, getOnplay, getOnplaying, getOnpointercancel, getOnpointerdown, getOnpointerenter, getOnpointerleave, getOnpointermove, getOnpointerout, getOnpointerover, getOnpointerup, getOnprogress, getOnratechange, getOnreset, getOnresize, getOnscroll, getOnseeked, getOnseeking, getOnselect, getOnselectstart, getOnshow, getOnstalled, getOnsubmit, getOnsuspend, getOntimeupdate, getOntoggle, getOntransitionend, getOnvolumechange, getOnwaiting, getOnwebkitanimationend, getOnwebkitanimationiteration, getOnwebkitanimationstart, getOnwebkittransitionend, getOnwheel, getOuterHTML, getParentElement, getParentHTMLElement, getPlatform, getPosX, getPosY, getPrefix, getRuntimeStyle, getStyle, getSystemLanguage, getTabIndex, getTitle, getUniqueID, getUserLanguage, getVAlign, getWidth, getWidthOrHeight, hasAttribute, insertAdjacentElement, insertAdjacentHTML, insertAdjacentText, isAncestorOfEventTarget, isComponentInstalled, isCookieEnabled, isEndTagForbidden, isHidden, isHomePage, isIsContentEditable, isJavaEnabled, isLowerCaseInOuterHtml, isSpellcheck, mergeAttributes, navigateHomePage, readAttributes, releaseCapture, removeBehavior, removeNode, scrollIntoView, setAccessKey, setActive, setAlign, setAttribute, setCapture, setCh, setChOff, setClassName_js, setColorAttribute, setContentEditable, setDir, setHidden, setHomePage, setId, setInnerHTML, setInnerText, setInnerTextImpl, setLang, setLanguage, setOnabort, setOnactivate, setOnanimationend, setOnanimationiteration, setOnanimationstart, setOnauxclick, setOnbeforeactivate, setOnbeforecopy, setOnbeforecut, setOnbeforedeactivate, setOnbeforepaste, setOnblur, setOncancel, setOncanplay, setOncanplaythrough, setOnchange, setOnclick, setOnclose, setOncontextmenu, setOncopy, setOncuechange, setOncut, setOndblclick, setOndeactivate, setOndrag, setOndragend, setOndragenter, setOndragexit, setOndragleave, setOndragover, setOndragstart, setOndrop, setOndurationchange, setOnemptied, setOnended, setOnerror, setOnfocus, setOnfocusin, setOnfocusout, setOngotpointercapture, setOnhelp, setOninput, setOninvalid, setOnkeydown, setOnkeypress, setOnkeyup, setOnload, setOnloadeddata, setOnloadedmetadata, setOnloadend, setOnloadstart, setOnlostpointercapture, setOnmousedown, setOnmouseenter, setOnmouseleave, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnmousewheel, setOnmozfullscreenchange, setOnmozfullscreenerror, setOnmscontentzoom, setOnmsmanipulationstatechanged, setOnpaste, setOnpause, setOnplay, setOnplaying, setOnpointercancel, setOnpointerdown, setOnpointerenter, setOnpointerleave, setOnpointermove, setOnpointerout, setOnpointerover, setOnpointerup, setOnprogress, setOnratechange, setOnreset, setOnresize, setOnscroll, setOnseeked, setOnseeking, setOnselect, setOnselectstart, setOnshow, setOnstalled, setOnsubmit, setOnsuspend, setOntimeupdate, setOntoggle, setOntransitionend, setOnvolumechange, setOnwaiting, setOnwebkitanimationend, setOnwebkitanimationiteration, setOnwebkitanimationstart, setOnwebkittransitionend, setOnwheel, setOuterHTML, setSpellcheck, setStyle, setTabIndex, setTagUrn, setTextContent, setTitle, setVAlign, setWidthOrHeight, startDownload, toString

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.Element

after, before, createAttributesObject, createEventHandler, createTextRange, get, getAttribute, getAttributeNodeNS, getAttributeNS, getAttributes, getChildElementCount, getClientHeight, getClientLeft, getClientRects, getClientTop, getClientWidth, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getInnerHTML, getLastElementChild, getNamespaceURI, getNextElementSibling, getOnmsgesturechange, getOnmsgesturedoubletap, getOnmsgestureend, getOnmsgesturehold, getOnmsgesturestart, getOnmsgesturetap, getOnmsgotpointercapture, getOnmsinertiastart, getOnmslostpointercapture, getOnmspointercancel, getOnmspointerdown, getOnmspointerenter, getOnmspointerleave, getOnmspointermove, getOnmspointerout, getOnmspointerover, getOnmspointerup, getOnsearch, getOnwebkitfullscreenchange, getOnwebkitfullscreenerror, getPreviousElementSibling, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getTagName, hasAttributeNS, hasAttributes, isDisplayNone, matches, mozMatchesSelector, msMatchesSelector, printChildren, querySelector, querySelectorAll, remove, removeAttribute, removeAttributeNode, removeAttributeNS, replaceWith, scrollIntoViewIfNeeded, setAttributeNode, setAttributeNS, setDefaults, setOnmsgesturechange, setOnmsgesturedoubletap, setOnmsgestureend, setOnmsgesturehold, setOnmsgesturestart, setOnmsgesturetap, setOnmsgotpointercapture, setOnmsinertiastart, setOnmslostpointercapture, setOnmspointercancel, setOnmspointerdown, setOnmspointerenter, setOnmspointerleave, setOnmspointermove, setOnmspointerout, setOnmspointerover, setOnmspointerup, setOnsearch, setOnwebkitfullscreenchange, setOnwebkitfullscreenerror, setScrollLeft, setScrollTop, webkitMatchesSelector

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.dom.Node

asJavaScriptException, cloneNode, compareDocumentPosition, getBaseURI, getChildNodes, getFirstChild, getJavaScriptNode, getLastChild, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getTextContent, hasChildNodes, insertBefore, isSameNode, normalize, removeChild, replaceChild, setNodeValue

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.event.EventTarget

addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, removeEventListener, setEventHandler

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

clone, equivalentValues, getBrowserVersion, getDefaultValue, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, getWithPreemption, has, hasInstance, initParentScope, isReadOnlySettable, makeScriptableFor, setCaseSensitive, setDomNode, setHtmlElement

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

defineFunctionProperties, defineProperty, getClassName, put, setClassName, setParentScope

Methods inherited from class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureSymbolScriptable, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSlot, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, putConst, putConstProperty, putProperty, putProperty, putProperty, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setExternalArrayData, setGetterOrSetter, setPrototype, size

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

HTMLSelectElement

public HTMLSelectElement()

Creates an instance.

Method Detail

initialize

public void initialize()

Initialize the object.

remove

public void remove(int index)

Removes option at the specified index.

Parameters:

index - the index of the item to remove

add

public void add(HTMLOptionElement newOptionObject,
                Object beforeOptionObject)

Adds a new item to the list (optionally) before the specified item.

Parameters:

newOptionObject - the DomNode to insert

beforeOptionObject - for Firefox: the DomNode to insert the previous element before (null if at end), for Internet Explorer: the index where the element should be placed (optional).

appendChild

public Object appendChild(Object childObject)

Adds a DOM node to the node.

Overrides:

appendChild in class Node

Parameters:

childObject - the node to add to this node

Returns:

the newly added child node

insertBeforeImpl

public Object insertBeforeImpl(Object[] args)

Add a DOM node as a child to this node before the referenced node. If the referenced node is null, append to the end.

Overrides:

insertBeforeImpl in class Node

Parameters:

args - the arguments

Returns:

the newly added child node

item

public Object item(int index)

Gets the item at the specified index.

Parameters:

index - the position of the option to retrieve

Returns:

the option

getType

public String getType()

Returns the type of this input.

Returns:

the type

getOptions

public HTMLOptionsCollection getOptions()

Returns the value of the options property.

Returns:

the options property

getSelectedIndex

public int getSelectedIndex()

Returns the value of the selectedIndex property.

Returns:

the selectedIndex property

setSelectedIndex

public void setSelectedIndex(int index)

Sets the value of the selectedIndex property.

Parameters:

index - the new value

getValue

public String getValue()

Returns the actual value of the selected Option.

Overrides:

getValue in class FormField

Returns:

the value

getLength

public int getLength()

Returns the value of the length property.

Returns:

the length property

setLength

public void setLength(int newLength)

Removes options by reducing the length property.

Parameters:

newLength - the new length property value

get

public Object get(int index,
                  net.sourceforge.htmlunit.corejs.javascript.Scriptable start)

Returns the specified indexed property.

Specified by:

get in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

get in class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

Parameters:

index - the index of the property

start - the scriptable object that was originally queried for this property

Returns:

the property

put

public void put(int index,
                net.sourceforge.htmlunit.corejs.javascript.Scriptable start,
                Object newValue)

Sets the index property.

Specified by:

put in interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

Overrides:

put in class net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

Parameters:

index - the index

start - the scriptable object that was originally invoked for this property

newValue - the new value

setValue

public void setValue(Object newValue)

Selects the option with the specified value.

Overrides:

setValue in class FormField

Parameters:

newValue - the value of the option to select

getSize

public int getSize()

Returns the size attribute.

Returns:

the size attribute

setSize

public void setSize(String size)

Sets the size attribute.

Parameters:

size - the size attribute

isMultiple

public boolean isMultiple()

Returns true if the multiple attribute is set.

Returns:

true if the multiple attribute is set

setMultiple

public void setMultiple(boolean multiple)

Sets or clears the multiple attribute.

Parameters:

multiple - true to set the multiple attribute, false to clear it

getLabels

public AbstractList getLabels()

Returns the labels associated with the element.

Returns:

the labels associated with the element

checkValidity

public boolean checkValidity()

Checks whether the element has any constraints and whether it satisfies them.

Returns:

if the element is valid

isRequired

public boolean isRequired()

Returns the required property.

Returns:

the required property

setRequired

public void setRequired(boolean required)

Sets the required property.

Parameters:

required - the new value