org.htmlunit.javascript.host.html

Class HTMLInputElement

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

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 HTMLInputElement
extends HTMLElement

The JavaScript object for HtmlInput.

Author:

Mike Bowler, Christian Sell, Marc Guillemot, Chris Erskine, Ahmed Ashour, Daniel Gredler, Ronald Brill, Frank Danek, Anton Demydenko

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

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
HTMLInputElement()

Method Summary

Modifier and Type	Method and Description
boolean	checkValidity() Checks whether the element has any constraints and whether it satisfies them.
void	click() Click this element.
String	getAccept() Returns the accept attribute.
String	getAlign() Returns the value of the align property.
String	getAlt() Returns the value of the alt property.
String	getAttribute(String attributeName)
String	getAutocomplete() Returns the autocomplete attribute.
String	getDefaultValue() Returns the input's default value, used if the containing form gets reset.
HtmlInput	getDomNodeOrDie() Returns the DOM node that corresponds to this JavaScript object or throw an exception if one cannot be found.
FileList	getFiles() Returns the files property.
HTMLFormElement	getForm() Returns the value of the JavaScript form attribute.
int	getHeight() Returns the height property.
NodeList	getLabels() Returns the labels associated with the element.
String	getMax() Gets the max property.
int	getMaxLength() Gets the max length.
String	getMin() Gets the min property.
int	getMinLength() Gets the minLength.
String	getName() Returns the value of the JavaScript attribute name.
String	getPlaceholder() Returns the placeholder attribute.
Integer	getSelectionEnd() Gets the value of selectionEnd attribute.
Integer	getSelectionStart() Gets the value of selectionStart attribute.
String	getSize() Returns the size attribute.
String	getSrc() Returns the value of the src attribute.
String	getStep() Gets the step property.
int	getTextLength() Gets the value of textLength attribute.
String	getType() Returns the type property.
ValidityState	getValidity()
String	getValue() Returns the value of the JavaScript attribute value.
int	getWidth() Returns the width property.
boolean	getWillValidate()
boolean	isChecked() Returns the value of the checked property.
boolean	isDefaultChecked() Returns the input's default checked value, used if the containing form gets reset.
boolean	isDisabled() Returns true if this element is disabled.
protected boolean	isEndTagForbidden() Returns whether the end tag is forbidden or not.
boolean	isFormNoValidate() Returns the value of the property formnovalidate.
boolean	isReadOnly() Gets the value of readOnly attribute.
boolean	isRequired() Returns the required property.
void	jsConstructor() JavaScript constructor.
void	select() Select this element.
void	setAccept(String accept) Sets the accept attribute.
void	setAlign(String align) Sets the value of the align property.
void	setAlt(String alt) Returns the value of the alt property.
void	setAutocomplete(String autocomplete) Sets the autocomplete attribute.
void	setChecked(boolean checked) Sets the checked property.
void	setCustomValidity(String message) Sets the custom validity message for the element to the specified message.
void	setDefaultChecked(boolean defaultChecked) Sets the input's default checked value, used if the containing form gets reset.
void	setDefaultValue(String defaultValue) Sets the input's default value, used if the containing form gets reset.
void	setDisabled(boolean disabled) Sets whether or not to disable this element.
void	setFormNoValidate(boolean value) Sets the value of the property formnovalidate.
void	setHeight(int height) Sets the height property.
void	setMax(String max) Sets the max property.
void	setMaxLength(int length) Sets the value of maxLength attribute.
void	setMin(String min) Sets the min property.
void	setMinLength(int length) Sets the value of minLength attribute.
void	setName(String newName) Sets the value of the JavaScript attribute name.
void	setPlaceholder(String placeholder) Sets the placeholder attribute.
void	setReadOnly(boolean readOnly) Sets the value of readOnly attribute.
void	setRequired(boolean required) Sets the required property.
void	setSelectionEnd(int end) Sets the value of selectionEnd attribute.
void	setSelectionRange(int start, int end) Sets the selected portion of this input element.
void	setSelectionStart(int start) Sets the value of selectionStart attribute.
void	setSize(String size) Sets the size attribute.
void	setSrc(String src) Sets the value of the src attribute.
void	setStep(String step) Sets the step property.
void	setType(String newType) Sets the value of the attribute type.
void	setValue(Object newValue) Sets the value of the JavaScript attribute value.
void	setWidth(int width) Sets the width property.

Methods inherited from class org.htmlunit.javascript.host.html.HTMLElement

blur, 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, 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, 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, appendChild, before, cloneNode, compareDocumentPosition, contains, getBaseURI, getChildNodes, getFirstChild, getJavaScriptNode, getLastChild, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getRootNode, getTextContent, hasChildNodes, insertBefore, insertBeforeImpl, 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, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureSymbolScriptable, get, 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, 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

HTMLInputElement

public HTMLInputElement()

Method Detail

jsConstructor

public void jsConstructor()

JavaScript constructor.

Overrides:

jsConstructor in class HTMLElement

getType

public String getType()

Returns the type property.

Returns:

the type property

setType

public void setType(String newType)

Sets the value of the attribute type. Note: this replace the DOM node with a new one.

Parameters:

newType - the new type to set

setValue

public void setValue(Object newValue)

Sets the value of the JavaScript attribute value.

Overrides:

setValue in class HTMLElement

Parameters:

newValue - the new value

setChecked

public void setChecked(boolean checked)

Sets the checked property. Although this property is defined in Input it doesn't make any sense for input's other than checkbox and radio. This implementation does nothing. The implementations in Checkbox and Radio actually do the work.

Parameters:

checked - True if this input should have the checked attribute set

getDomNodeOrDie

public HtmlInput 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

isChecked

public boolean isChecked()

Returns the value of the checked property. Although this property is defined in Input it doesn't make any sense for input's other than checkbox and radio. This implementation does nothing. The implementations in Checkbox and Radio actually do the work.

Returns:

the checked property

select

public void select()

Select this element.

getDefaultValue

public String getDefaultValue()

Returns the input's default value, used if the containing form gets reset.

Returns:

the input's default value, used if the containing form gets reset

See Also:

MSDN Documentation

setDefaultValue

public void setDefaultValue(String defaultValue)

Sets the input's default value, used if the containing form gets reset.

Parameters:

defaultValue - the input's default value, used if the containing form gets reset

See Also:

MSDN Documentation

isDefaultChecked

public boolean isDefaultChecked()

Returns the input's default checked value, used if the containing form gets reset.

Returns:

the input's default checked value, used if the containing form gets reset

See Also:

MSDN Documentation

setDefaultChecked

public void setDefaultChecked(boolean defaultChecked)

Sets the input's default checked value, used if the containing form gets reset.

Parameters:

defaultChecked - the input's default checked value, used if the containing form gets reset

See Also:

MSDN Documentation

getTextLength

public int getTextLength()

Gets the value of textLength attribute.

Returns:

the text length

getSelectionStart

public Integer getSelectionStart()

Gets the value of selectionStart attribute.

Returns:

the selection start

setSelectionStart

public void setSelectionStart(int start)

Sets the value of selectionStart attribute.

Parameters:

start - selection start

getSelectionEnd

public Integer getSelectionEnd()

Gets the value of selectionEnd attribute.

Returns:

the selection end

setSelectionEnd

public void setSelectionEnd(int end)

Sets the value of selectionEnd attribute.

Parameters:

end - selection end

getMaxLength

public int getMaxLength()

Gets the max length.

Returns:

the max length

setMaxLength

public void setMaxLength(int length)

Sets the value of maxLength attribute.

Parameters:

length - the new value

getMinLength

public int getMinLength()

Gets the minLength.

Returns:

the minLength

setMinLength

public void setMinLength(int length)

Sets the value of minLength attribute.

Parameters:

length - the new value

getMin

public String getMin()

Gets the min property.

Returns:

the min property

setMin

public void setMin(String min)

Sets the min property.

Parameters:

min - the min property

getMax

public String getMax()

Gets the max property.

Returns:

the max property

setMax

public void setMax(String max)

Sets the max property.

Parameters:

max - the max property

getStep

public String getStep()

Gets the step property.

Returns:

the step property

setStep

public void setStep(String step)

Sets the step property.

Parameters:

step - the step property

isReadOnly

public boolean isReadOnly()

Gets the value of readOnly attribute.

Returns:

the readOnly attribute

setReadOnly

public void setReadOnly(boolean readOnly)

Sets the value of readOnly attribute.

Parameters:

readOnly - the new value

setSelectionRange

public void setSelectionRange(int start,
                              int end)

Sets the selected portion of this input element.

Parameters:

start - the index of the first character to select

end - the index of the character after the selection

getAlt

public String getAlt()

Returns the value of the alt property.

Returns:

the value of the alt property

setAlt

public void setAlt(String alt)

Returns the value of the alt property.

Parameters:

alt - the value

getAlign

public String getAlign()

Returns the value of the align property.

Returns:

the value of the align property

setAlign

public void setAlign(String align)

Sets the value of the align property.

Parameters:

align - the value of the align property

getSrc

public String getSrc()

Returns the value of the src attribute.

Returns:

the value of the src attribute

setSrc

public void setSrc(String src)

Sets the value of the src attribute.

Parameters:

src - the new value

getValue

public String getValue()

Returns the value of the JavaScript attribute value.

Overrides:

getValue in class HTMLElement

Returns:

the value of this attribute

getAttribute

public String getAttribute(String attributeName)

Overrides:

getAttribute in class Element

Parameters:

attributeName - attribute name

Returns:

the value of the specified attribute, null if the attribute is not defined

click

public void click()
           throws IOException

Click this element. This simulates the action of the user clicking with the mouse.

Overrides:

click in class HTMLElement

Throws:

IOException - if this click triggers a page load that encounters problems

isEndTagForbidden

protected boolean isEndTagForbidden()

Returns whether the end tag is forbidden or not.

Overrides:

isEndTagForbidden in class HTMLElement

Returns:

whether the end tag is forbidden or not

See Also:

HTML 4 specs

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

getSize

public String getSize()

Returns the size attribute.

Returns:

the size attribute

setSize

public void setSize(String size)

Sets the size attribute.

Parameters:

size - the new size value

getAccept

public String getAccept()

Returns the accept attribute.

Returns:

the accept attribute

setAccept

public void setAccept(String accept)

Sets the accept attribute.

Parameters:

accept - the new accept value

getAutocomplete

public String getAutocomplete()

Returns the autocomplete attribute.

Returns:

the autocomplete attribute

setAutocomplete

public void setAutocomplete(String autocomplete)

Sets the autocomplete attribute.

Parameters:

autocomplete - the new autocomplete value

getFiles

public FileList getFiles()

Returns the files property.

Returns:

the files property

getPlaceholder

public String getPlaceholder()

Returns the placeholder attribute.

Returns:

the placeholder attribute

setPlaceholder

public void setPlaceholder(String placeholder)

Sets the placeholder attribute.

Parameters:

placeholder - the new placeholder value

getWidth

public int getWidth()

Returns the width property.

Returns:

the width property

setWidth

public void setWidth(int width)

Sets the width property.

Parameters:

width - the width property

getHeight

public int getHeight()

Returns the height property.

Returns:

the height property

setHeight

public void setHeight(int height)

Sets the height property.

Parameters:

height - the height property

getLabels

public NodeList 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

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

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

isFormNoValidate

public boolean isFormNoValidate()

Returns the value of the property formnovalidate.

Returns:

the value of this property

setFormNoValidate

public void setFormNoValidate(boolean value)

Sets the value of the property formnovalidate.

Parameters:

value - the new value