Class HTMLSelectElement

java.lang.Object

org.htmlunit.corejs.javascript.ScriptableObject

org.htmlunit.javascript.HtmlUnitScriptable

org.htmlunit.javascript.host.event.EventTarget

org.htmlunit.javascript.host.dom.Node

org.htmlunit.javascript.host.Element

org.htmlunit.javascript.host.html.HTMLElement

org.htmlunit.javascript.host.html.HTMLSelectElement

All Implemented Interfaces:

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

public class HTMLSelectElement
extends HTMLElement

The JavaScript object for HtmlSelect.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class HTMLElement

HTMLElement.ProxyDomNode

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

org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator

Field Summary

Fields

Modifier and Type	Field	Description
private NodeList	labels_	"Live" labels collection; has to be a member to have equality (==) working.
private HTMLOptionsCollection	optionsArray_

Fields inherited from class 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 org.htmlunit.corejs.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor	Description
HTMLSelectElement()	Creates an instance.

Method Summary

Modifier and Type	Method	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, org.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.
org.htmlunit.corejs.javascript.Scriptable	iterator()
void	jsConstructor()	JavaScript constructor.
void	put(int index, org.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 HTMLElement

blur, click, focus, getAccessKey, getAlign, getAttributeNode, getAutofocus, getBoundingClientRect, getCh, getChOff, getContentEditable, getDataset, getDir, getDomNodeOrNull, getEnterKeyHint, getInnerText, getLang, getLocalName, getNodeName, getOffsetHeight, getOffsetLeft, getOffsetParent_js, getOffsetTop, getOffsetWidth, getOnabort, getOnanimationcancel, getOnanimationend, getOnanimationiteration, getOnanimationstart, getOnauxclick, getOnblur, getOncancel, getOncanplay, getOncanplaythrough, getOnchange, getOnclick, getOnclose, getOncontextmenu, getOncopy, getOncuechange, getOncut, getOndblclick, getOndrag, getOndragend, getOndragenter, getOndragleave, getOndragover, getOndragstart, getOndrop, getOndurationchange, getOnemptied, getOnended, getOnerror, getOnfocus, getOngotpointercapture, getOninput, getOninvalid, getOnkeydown, getOnkeypress, getOnkeyup, getOnload, getOnloadeddata, getOnloadedmetadata, getOnloadstart, getOnlostpointercapture, getOnmousedown, getOnmouseenter, getOnmouseleave, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnmousewheel, getOnmozfullscreenchange, getOnmozfullscreenerror, getOnpaste, getOnpause, getOnplay, getOnplaying, getOnpointercancel, getOnpointerdown, getOnpointerenter, getOnpointerleave, getOnpointermove, getOnpointerout, getOnpointerover, getOnpointerup, getOnprogress, getOnratechange, getOnreset, getOnresize, getOnscroll, getOnscrollend, getOnseeked, getOnseeking, getOnselect, getOnselectionchange, getOnselectstart, getOnstalled, getOnsubmit, getOnsuspend, getOntimeupdate, getOntoggle, getOntransitioncancel, getOntransitionend, getOntransitionrun, getOntransitionstart, getOnvolumechange, getOnwaiting, getOnwheel, getOuterText, getParentHTMLElement, getPosX, getPosY, getPrefix, getStyle, getTabIndex, getTitle, getVAlign, getWidthOrHeight, isAncestorOfEventTarget, isEndTagForbidden, isHidden, isIsContentEditable, isLowerCaseInOuterHtml, isSpellcheck, setAccessKey, setAlign, setAttribute, setAutofocus, setCh, setChOff, setColorAttribute, setContentEditable, setDir, setDomNode, setEnterKeyHint, setHidden, setInnerText, setLang, setOnabort, setOnanimationcancel, setOnanimationend, setOnanimationiteration, setOnanimationstart, setOnauxclick, setOnblur, setOncancel, setOncanplay, setOncanplaythrough, setOnchange, setOnclick, setOnclose, setOncontextmenu, setOncopy, setOncuechange, setOncut, setOndblclick, setOndrag, setOndragend, setOndragenter, setOndragleave, setOndragover, setOndragstart, setOndrop, setOndurationchange, setOnemptied, setOnended, setOnerror, setOnfocus, setOngotpointercapture, setOninput, setOninvalid, setOnkeydown, setOnkeypress, setOnkeyup, setOnload, setOnloadeddata, setOnloadedmetadata, setOnloadstart, setOnlostpointercapture, setOnmousedown, setOnmouseenter, setOnmouseleave, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnmousewheel, setOnmozfullscreenchange, setOnmozfullscreenerror, setOnpaste, setOnpause, setOnplay, setOnplaying, setOnpointercancel, setOnpointerdown, setOnpointerenter, setOnpointerleave, setOnpointermove, setOnpointerout, setOnpointerover, setOnpointerup, setOnprogress, setOnratechange, setOnreset, setOnresize, setOnscroll, setOnscrollend, setOnseeked, setOnseeking, setOnselect, setOnselectionchange, setOnselectstart, setOnstalled, setOnsubmit, setOnsuspend, setOntimeupdate, setOntoggle, setOntransitioncancel, setOntransitionend, setOntransitionrun, setOntransitionstart, setOnvolumechange, setOnwaiting, setOnwheel, setOuterText, setSpellcheck, setStyle, setTabIndex, setTextContent, setTitle, setVAlign, setWidthOrHeight, toString

Methods inherited from class Element

after, append, before, closest, createAttributesObject, createEventHandler, getAttribute, getAttributeNodeNS, getAttributeNS, getAttributes, getChildElementCount, getChildren, getClassList, getClassName_js, getClientHeight, getClientLeft, getClientRects, getClientTop, getClientWidth, getElementsByClassName, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getId, getInnerHTML, getInnerHTML, getLastElementChild, getNamespaceURI, getNextElementSibling, getOnbeforecopy, getOnbeforecut, getOnbeforepaste, getOnsearch, getOnwebkitfullscreenchange, getOnwebkitfullscreenerror, getOuterHTML, getParentElement, getPreviousElementSibling, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getTagName, hasAttribute, hasAttributeNS, hasAttributes, innerHTML, insertAdjacentElement, insertAdjacentHTML, insertAdjacentText, isDisplayNone, matches, mozMatchesSelector, prepend, printChildren, printNode, querySelector, querySelectorAll, releaseCapture, remove, removeAttribute, removeAttributeNode, removeAttributeNS, replaceChildren, replaceWith, scroll, scrollBy, scrollIntoView, scrollIntoViewIfNeeded, scrollTo, setAttributeNode, setAttributeNS, setCapture, setClassName_js, setId, setInnerHTML, setOnbeforecopy, setOnbeforecut, setOnbeforepaste, setOnsearch, setOnwebkitfullscreenchange, setOnwebkitfullscreenerror, setOuterHTML, setScrollLeft, setScrollTop, toggleAttribute, webkitMatchesSelector

Methods inherited from class Node

after, append, before, cloneNode, compareDocumentPosition, contains, getBaseURI, getChildNodes, getFirstChild, getJavaScriptNode, getLastChild, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getRootNode, getTextContent, hasChildNodes, insertBefore, isEqualNode, isSameNode, normalize, prepend, removeChild, replaceChild, replaceChildren, replaceWith, setNodeValue

Methods inherited from class EventTarget

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

Methods inherited from class HtmlUnitScriptable

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

Methods inherited from class org.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, defineProperty, delete, delete, delete, deleteProperty, 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 Object

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

Field Details

optionsArray_

private HTMLOptionsCollection optionsArray_

labels_

private NodeList labels_

"Live" labels collection; has to be a member to have equality (==) working.

Constructor Details

HTMLSelectElement

public HTMLSelectElement()

Creates an instance.

Method Details

jsConstructor

public void jsConstructor()

JavaScript constructor.

Overrides:

jsConstructor in class HTMLElement

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 - the DomNode to insert the previous element before (null if at end).

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,
 org.htmlunit.corejs.javascript.Scriptable start)

Returns the specified indexed property.

Specified by:

get in interface org.htmlunit.corejs.javascript.Scriptable

Overrides:

get in class org.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,
 org.htmlunit.corejs.javascript.Scriptable start,
 Object newValue)

Sets the index property.

Specified by:

put in interface org.htmlunit.corejs.javascript.Scriptable

Overrides:

put in class org.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

iterator

public org.htmlunit.corejs.javascript.Scriptable iterator()