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 

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 org.htmlunit.javascript.host.html.HTMLElement

    HTMLElement.ProxyDomNode

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

    org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator, org.htmlunit.corejs.javascript.ScriptableObject.LambdaGetterFunction, org.htmlunit.corejs.javascript.ScriptableObject.LambdaSetterFunction

• Field Summary

  • 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

  • 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 and Description
  HTMLSelectElement ()

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  void	add (HTMLOptionElement newOptionObject, Object beforeOptionObject) Adds a new item to the list (optionally) before the specified item.
  Node	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.
  Node	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 org.htmlunit.javascript.host.html.HTMLElement

    blur, click, focus, getAccessKey, getAlign, getAttributeNode, getAutofocus, getBoundingClientRect, getCh, getChOff, getContentEditable, getDataset, getDir, getDomNodeOrNull, getEnterKeyHint, getHidden, 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, 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, getHTML, getId, getInnerHTML, getInnerHTML, getLastElementChild, getNamespaceURI, getNextElementSibling, getOnbeforecopy, getOnbeforecut, getOnbeforepaste, getOnsearch, getOnwebkitfullscreenchange, getOnwebkitfullscreenerror, getOuterHTML, getParentElement, getPreviousElementSibling, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getTagName, hasAttribute, hasAttributeNS, hasAttributes, 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, lookupPrefix, 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, getWindow, getWindow, getWindowFromTopCallScope, 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, checkPropertyChangeForSlot, checkPropertyDefinition, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, 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, getSuperProperty, getSuperProperty, getSuperProperty, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, putConst, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setPrototype, size

  • Methods inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

    createSlotMap

  • Methods inherited from class java.lang.Object

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

• Constructor Detail

  • HTMLSelectElement

    public HTMLSelectElement()

• Method Detail

  • 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 Node 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 Node 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()

    Returns:

    the Iterator symbol