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:
java.io.Serializable
,java.lang.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 forHtmlSelect
.- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class org.htmlunit.javascript.host.html.HTMLElement
HTMLElement.ProxyDomNode
-
-
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 org.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
-
-
Constructor Summary
Constructors Constructor Description HTMLSelectElement()
Creates an instance.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description void
add(HTMLOptionElement newOptionObject, java.lang.Object beforeOptionObject)
Adds a new item to the list (optionally) before the specified item.java.lang.Object
appendChild(java.lang.Object childObject)
Adds a DOM node to the node.boolean
checkValidity()
Checks whether the element has any constraints and whether it satisfies them.java.lang.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 JavaScriptform
attribute.NodeList
getLabels()
Returns the labels associated with the element.int
getLength()
Returns the value of thelength
property.java.lang.String
getName()
Returns the value of the JavaScript attributename
.HTMLOptionsCollection
getOptions()
Returns the value of theoptions
property.int
getSelectedIndex()
Returns the value of theselectedIndex
property.int
getSize()
Returns thesize
attribute.java.lang.String
getType()
Returns the type of this input.ValidityState
getValidity()
java.lang.String
getValue()
Returns the actual value of the selected Option.boolean
getWillValidate()
void
initialize()
Initialize the object.java.lang.Object
insertBeforeImpl(java.lang.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()
Returnstrue
if themultiple
attribute is set.boolean
isRequired()
Returns therequired
property.java.lang.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, java.lang.Object newValue)
Sets the index property.void
remove(int index)
Removes option at the specified index.void
setCustomValidity(java.lang.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 thelength
property.void
setMultiple(boolean multiple)
Sets or clears themultiple
attribute.void
setName(java.lang.String newName)
Sets the value of the JavaScript attributename
.void
setRequired(boolean required)
Sets therequired
property.void
setSelectedIndex(int index)
Sets the value of theselectedIndex
property.void
setSize(java.lang.String size)
Sets thesize
attribute.void
setValue(java.lang.Object newValue)
Selects the option with the specified value.-
Methods inherited from class org.htmlunit.javascript.host.html.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 org.htmlunit.javascript.host.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 org.htmlunit.javascript.host.dom.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 org.htmlunit.javascript.host.event.EventTarget
addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, removeEventListener, setEventHandler
-
Methods inherited from class org.htmlunit.javascript.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
-
-
-
-
Field Detail
-
optionsArray_
private HTMLOptionsCollection optionsArray_
-
labels_
private NodeList labels_
"Live" labels collection; has to be a member to have equality (==) working.
-
-
Method Detail
-
jsConstructor
public void jsConstructor()
JavaScript constructor.- Overrides:
jsConstructor
in classHTMLElement
-
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 classHTMLElement
- 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, java.lang.Object beforeOptionObject)
Adds a new item to the list (optionally) before the specified item.- Parameters:
newOptionObject
- the DomNode to insertbeforeOptionObject
- the DomNode to insert the previous element before (null if at end).
-
appendChild
public java.lang.Object appendChild(java.lang.Object childObject)
Adds a DOM node to the node.- Overrides:
appendChild
in classNode
- Parameters:
childObject
- the node to add to this node- Returns:
- the newly added child node
-
insertBeforeImpl
public java.lang.Object insertBeforeImpl(java.lang.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 classNode
- Parameters:
args
- the arguments- Returns:
- the newly added child node
-
item
public java.lang.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 java.lang.String getType()
Returns the type of this input.- Returns:
- the type
-
getOptions
public HTMLOptionsCollection getOptions()
Returns the value of theoptions
property.- Returns:
- the
options
property
-
getSelectedIndex
public int getSelectedIndex()
Returns the value of theselectedIndex
property.- Returns:
- the
selectedIndex
property
-
setSelectedIndex
public void setSelectedIndex(int index)
Sets the value of theselectedIndex
property.- Parameters:
index
- the new value
-
getValue
public java.lang.String getValue()
Returns the actual value of the selected Option.- Overrides:
getValue
in classHTMLElement
- Returns:
- the value
-
getLength
public int getLength()
Returns the value of thelength
property.- Returns:
- the
length
property
-
setLength
public void setLength(int newLength)
Removes options by reducing thelength
property.- Parameters:
newLength
- the newlength
property value
-
get
public java.lang.Object get(int index, org.htmlunit.corejs.javascript.Scriptable start)
Returns the specified indexed property.- Specified by:
get
in interfaceorg.htmlunit.corejs.javascript.Scriptable
- Overrides:
get
in classorg.htmlunit.corejs.javascript.ScriptableObject
- Parameters:
index
- the index of the propertystart
- 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, java.lang.Object newValue)
Sets the index property.- Specified by:
put
in interfaceorg.htmlunit.corejs.javascript.Scriptable
- Overrides:
put
in classorg.htmlunit.corejs.javascript.ScriptableObject
- Parameters:
index
- the indexstart
- the scriptable object that was originally invoked for this propertynewValue
- the new value
-
setValue
public void setValue(java.lang.Object newValue)
Selects the option with the specified value.- Overrides:
setValue
in classHTMLElement
- Parameters:
newValue
- the value of the option to select
-
getSize
public int getSize()
Returns thesize
attribute.- Returns:
- the
size
attribute
-
setSize
public void setSize(java.lang.String size)
Sets thesize
attribute.- Parameters:
size
- thesize
attribute
-
isMultiple
public boolean isMultiple()
Returnstrue
if themultiple
attribute is set.- Returns:
true
if themultiple
attribute is set
-
setMultiple
public void setMultiple(boolean multiple)
Sets or clears themultiple
attribute.- Parameters:
multiple
-true
to set themultiple
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 therequired
property.- Returns:
- the
required
property
-
setRequired
public void setRequired(boolean required)
Sets therequired
property.- Parameters:
required
- the new value
-
getName
public java.lang.String getName()
Returns the value of the JavaScript attributename
.- Overrides:
getName
in classHTMLElement
- Returns:
- the value of this attribute
-
setName
public void setName(java.lang.String newName)
Sets the value of the JavaScript attributename
.- Overrides:
setName
in classHTMLElement
- Parameters:
newName
- the new name
-
isDisabled
public boolean isDisabled()
Returns true if this element is disabled. Overridden to modify browser configurations.- Overrides:
isDisabled
in classHTMLElement
- 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 classHTMLElement
- Parameters:
disabled
- True if this is to be disabled
-
getForm
public HTMLFormElement getForm()
Returns the value of the JavaScriptform
attribute.- Overrides:
getForm
in classHTMLElement
- 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(java.lang.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()
-
-