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.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.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 HTMLElement

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.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.
HtmlSelect	getDomNodeOrDie() Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.
HTMLFormElement	getForm() Returns the value of the JavaScript form attribute.
NodeList	getLabels() Returns the labels associated with the element.
int	getLength() Returns the value of the length property.
String	getName() Returns the value of the JavaScript attribute name.
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.
ValidityState	getValidity()
String	getValue() Returns the actual value of the selected Option.
boolean	getWillValidate()
void	initialize() Initialize the object.
Object	insertBeforeImpl(Object[] args) Add a DOM node as a child to this node before the referenced node.
boolean	isDisabled() Returns true if this element is disabled.
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	setCustomValidity(String message) Sets the custom validity message for the element to the specified message.
void	setDisabled(boolean disabled) Sets whether or not to disable this element.
void	setLength(int newLength) Removes options by reducing the length property.
void	setMultiple(boolean multiple) Sets or clears the multiple attribute.
void	setName(String newName) Sets the value of the JavaScript attribute name.
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.HTMLElement

blur, clearAttributes, click, contains, focus, getAccessKey, getAlign, getAttributeNode, getBoundingClientRect, getCh, getChildren, getChOff, getClassList, getClassName_js, getContentEditable, getCurrentStyle, getDataset, getDir, getDomNodeOrNull, getElementsByClassName, getEnterKeyHint, getId, getInnerHTML, getInnerText, getLang, getLanguage, getLocalName, getNodeName, getOffsetHeight, getOffsetLeft, getOffsetParent_js, getOffsetTop, getOffsetWidth, getOnabort, getOnactivate, getOnanimationcancel, 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, getOndragleave, getOndragover, getOndragstart, getOndrop, getOndurationchange, getOnemptied, getOnended, getOnerror, getOnfocus, getOnfocusin, getOnfocusout, getOngotpointercapture, getOnhelp, getOninput, getOninvalid, getOnkeydown, getOnkeypress, getOnkeyup, getOnload, getOnloadeddata, getOnloadedmetadata, 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, getOnselectionchange, getOnselectstart, getOnstalled, getOnsubmit, getOnsuspend, getOntimeupdate, getOntoggle, getOntransitioncancel, getOntransitionend, getOntransitionrun, getOntransitionstart, getOnvolumechange, getOnwaiting, getOnwheel, getOuterHTML, getOuterText, getParentElement, getParentHTMLElement, getPosX, getPosY, getPrefix, getRuntimeStyle, getStyle, getTabIndex, getTitle, getUniqueID, getVAlign, getWidthOrHeight, insertAdjacentElement, insertAdjacentHTML, insertAdjacentText, isAncestorOfEventTarget, isEndTagForbidden, isHidden, isIsContentEditable, isLowerCaseInOuterHtml, isSpellcheck, mergeAttributes, readAttributes, releaseCapture, removeNode, scrollIntoView, setAccessKey, setActive, setAlign, setAttribute, setCapture, setCh, setChOff, setClassName_js, setColorAttribute, setContentEditable, setDir, setDomNode, setEnterKeyHint, setHidden, setId, setInnerHTML, setInnerText, setLang, setLanguage, setOnabort, setOnactivate, setOnanimationcancel, 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, setOndragleave, setOndragover, setOndragstart, setOndrop, setOndurationchange, setOnemptied, setOnended, setOnerror, setOnfocus, setOnfocusin, setOnfocusout, setOngotpointercapture, setOnhelp, setOninput, setOninvalid, setOnkeydown, setOnkeypress, setOnkeyup, setOnload, setOnloadeddata, setOnloadedmetadata, 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, setOnselectionchange, setOnselectstart, setOnstalled, setOnsubmit, setOnsuspend, setOntimeupdate, setOntoggle, setOntransitioncancel, setOntransitionend, setOntransitionrun, setOntransitionstart, setOnvolumechange, setOnwaiting, setOnwheel, setOuterHTML, setSpellcheck, setStyle, setTabIndex, setTextContent, setTitle, setVAlign, setWidthOrHeight, toString

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

after, before, closest, 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, hasAttribute, hasAttributeNS, hasAttributes, innerHTML, isDisplayNone, matches, mozMatchesSelector, msMatchesSelector, printChildren, printNode, 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, toggleAttribute, 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, getRootNode, 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.HtmlUnitScriptable

clone, equivalentValues, getBrowserVersion, getClassName, getDefaultValue, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, getWithPreemption, has, hasInstance, initParentScope, makeScriptableFor, put, setClassName, setDomNode, setParentScope

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

applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, 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, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, 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, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, 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.

getDomNodeOrDie

public HtmlSelect getDomNodeOrDie()

Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.

Overrides:

getDomNodeOrDie in class HTMLElement

Returns:

the DOM node

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 HTMLElement

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 HTMLElement

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 NodeList getLabels()

Returns the labels associated with the element.

Returns:

the labels associated with the element

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

getName

public String getName()

Returns the value of the JavaScript attribute name.

Overrides:

getName in class HTMLElement

Returns:

the value of this attribute

setName

public void setName(String newName)

Sets the value of the JavaScript attribute name.

Overrides:

setName in class HTMLElement

Parameters:

newName - the new name

isDisabled

public boolean isDisabled()

Returns true if this element is disabled. Overridden to modify browser configurations.

Overrides:

isDisabled in class HTMLElement

Returns:

true if this element is disabled

setDisabled

public void setDisabled(boolean disabled)

Sets whether or not to disable this element. Overridden to modify browser configurations.

Overrides:

setDisabled in class HTMLElement

Parameters:

disabled - True if this is to be disabled

getForm

public HTMLFormElement getForm()

Returns the value of the JavaScript form attribute.

Overrides:

getForm in class HTMLElement

Returns:

the value of the JavaScript form attribute

checkValidity

public boolean checkValidity()

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

Returns:

if the element is valid

getValidity

public ValidityState getValidity()

Returns:

a ValidityState with the validity states that this element is in.

getWillValidate

public boolean getWillValidate()

Returns:

whether the element is a candidate for constraint validation

setCustomValidity

public void setCustomValidity(String message)

Sets the custom validity message for the element to the specified message.

Parameters:

message - the new message