com.gargoylesoftware.htmlunit.javascript.host.html

Class HTMLInputElement

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

com.gargoylesoftware.htmlunit.javascript.host.event.EventTarget

com.gargoylesoftware.htmlunit.javascript.host.dom.Node

com.gargoylesoftware.htmlunit.javascript.host.dom.EventNode

com.gargoylesoftware.htmlunit.javascript.host.Element

com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

com.gargoylesoftware.htmlunit.javascript.host.html.FormChild

com.gargoylesoftware.htmlunit.javascript.host.html.FormField

com.gargoylesoftware.htmlunit.javascript.host.html.HTMLInputElement

All Implemented Interfaces:

ScriptableWithFallbackGetter, Serializable, Cloneable, net.sourceforge.htmlunit.corejs.javascript.ConstProperties, net.sourceforge.htmlunit.corejs.javascript.debug.DebuggableObject, net.sourceforge.htmlunit.corejs.javascript.Scriptable

public class HTMLInputElement
extends FormField

The JavaScript object for HTMLInputElement.

Author:

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

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

HTMLElement.ProxyDomNode

Field Summary

Fields inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

BEHAVIOR_ID_CLIENT_CAPS, BEHAVIOR_ID_DOWNLOAD, BEHAVIOR_ID_HOMEPAGE

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
HTMLInputElement() Creates an instance.

Method Summary

Methods

Modifier and Type	Method and Description
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	getAutocomplete() Returns the autocomplete attribute.
String	getBorder() Gets the border attribute.
boolean	getChecked() Returns the value of the checked property.
boolean	getDefaultChecked() Returns the input's default checked value, used if the containing form gets reset.
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.
Object	getFiles() Returns the files property.
int	getHeight() Returns the height property.
AbstractList	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	getPlaceholder() Returns the placeholder attribute.
boolean	getReadOnly() Gets the value of readOnly attribute.
int	getSelectionEnd() Gets the value of selectionEnd attribute.
int	getSelectionStart() Gets the value of selectionStart attribute.
String	getSize() Returns the size attribute.
String	getSrc() Returns the value of the src attribute.
int	getTextLength() Gets the value of textLength attribute.
String	getType() Returns the type property.
int	getWidth() Returns the width property.
protected boolean	isEndTagForbidden() Returns whether the end tag is forbidden or not.
boolean	isRequired() Returns the required attribute.
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	setAttribute(String name, String value) Uses setType(String) if attribute's name is type to replace DOM node as well as long as we have subclasses of HtmlInput.
void	setAutocomplete(String autocomplete) Sets the autocomplete attribute.
void	setBorder(String border) Sets the border attribute.
void	setChecked(boolean checked) Sets the checked property.
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	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	setPlaceholder(String placeholder) Sets the placeholder attribute.
void	setReadOnly(boolean readOnly) Sets the value of readOnly attribute.
void	setRequired(boolean required) Sets the required attribute.
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	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 com.gargoylesoftware.htmlunit.javascript.host.html.FormField

getDisabled, getName, getOnchange, getValue, setDisabled, setDomNode, setName, setOnchange

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.FormChild

getForm

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.html.HTMLElement

addBehavior, addComponentRequest, blur, clearAttributes, clearComponentRequest, compareVersions, createTextRange, doComponentRequest, focus, getAccessKey, getAlign, getAttributeNode, getAttributeNodeNS, getAvailHeight, getAvailWidth, getBoundingClientRect, getBufferDepth, getCh, getChildren, getChOff, getClassList, getClassName_js, getClientHeight, getClientLeft, getClientRects, getClientTop, getClientWidth, getColorDepth, getComponentVersion, getConnectionType, getContentEditable, getCookieEnabled, getCpuClass, getDataset, getDefaultStyleDisplay, getDir, getDomNodeOrNull, getElementsByClassName, getId, getInnerHTML, getInnerText, getIsContentEditable, getJavaEnabled, getLang, getLanguage, getLocalName, getNodeName, getOffsetHeight, getOffsetLeft, getOffsetParent_js, getOffsetTop, getOffsetWidth, getOnsubmit, getOuterHTML, getParentElement, getParentHTMLElement, getPlatform, getPosX, getPosY, getPrefix, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getSpellcheck, getSystemLanguage, getTabIndex, getTitle, getUniqueID, getUserLanguage, getVAlign, getWidthOrHeight, getWithFallback, hasAttribute, insertAdjacentElement, insertAdjacentHTML, insertAdjacentText, isAncestorOfEventTarget, isComponentInstalled, isHomePage, isLowerCaseInOuterHtml, mergeAttributes, navigateHomePage, parseHtmlSnippet, readAttributes, releaseCapture, removeAttributeNode, removeBehavior, removeNode, scrollIntoView, setAccessKey, setActive, setAlign, setCapture, setCh, setChOff, setClassName_js, setColorAttribute, setContentEditable, setDir, setHomePage, setId, setInnerHTML, setInnerText, setInnerTextImpl, setLang, setLanguage, setOnsubmit, setOuterHTML, setScrollLeft, setScrollTop, setSpellcheck, setTabIndex, setTagUrn, setTextContent, setTitle, setVAlign, setWidthOrHeight, startDownload, toString

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

createAttributesObject, createEventHandler, get, getAttribute, getAttributeNS, getAttributes, getBaseURI, getChildElementCount, getCurrentStyle, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getLastElementChild, getNextElementSibling, getPreviousElementSibling, getRuntimeStyle, getStyle, getTagName, hasAttributeNS, querySelector, querySelectorAll, removeAttribute, removeAttributeNS, setAttributeNode, setAttributeNS, setDefaults

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.dom.EventNode

fireEvent, getOnblur, getOnclick, getOncontextmenu, getOndblclick, getOnerror, getOnfocus, getOnfocusin, getOnfocusout, getOninput, getOnkeydown, getOnkeypress, getOnkeyup, getOnmousedown, getOnmousemove, getOnmouseout, getOnmouseover, getOnmouseup, getOnpropertychange, getOnresize, setOnblur, setOnclick, setOncontextmenu, setOndblclick, setOnerror, setOnfocus, setOnfocusin, setOnfocusout, setOninput, setOnkeydown, setOnkeypress, setOnkeyup, setOnmousedown, setOnmousemove, setOnmouseout, setOnmouseover, setOnmouseup, setOnpropertychange, setOnresize

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.dom.Node

appendChild, asJavaScriptException, cloneNode, compareDocumentPosition, contains, detachEvent, getChildNodes, getFirstChild, getJavaScriptNode, getLastChild, getNamespaceURI, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getTextContent, hasChildNodes, insertBefore, insertBeforeImpl, isSameNode, normalize, remove, removeChild, replaceChild, setNodeValue

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.host.event.EventTarget

addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventHandlerProp, getEventListenersContainer, hasEventHandlers, removeEventListener, setEventHandler, setEventHandlerProp

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.SimpleScriptable

clone, equivalentValues, getBrowserVersion, getDefaultValue, getPrototype, getScriptableFor, getStartingScope, getWindow, getWindow, getWithPreemption, hasInstance, initParentScope, isReadOnlySettable, makeScriptableFor, setCaseSensitive, setDomNode, setHtmlElement

Methods inherited from class com.gargoylesoftware.htmlunit.javascript.HtmlUnitScriptable

defineFunctionProperties, defineProperty, getClassName, setClassName, setParentScope

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

applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, delete, delete, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGetterOrSetter, getIds, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getPropertyIds, getPrototype, getSlot, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, has, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, put, putConst, putConstProperty, putProperty, putProperty, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setExternalArrayData, setGetterOrSetter, setPrototype, size

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sourceforge.htmlunit.corejs.javascript.Scriptable

delete, delete, get, get, getClassName, getDefaultValue, getIds, getParentScope, getPrototype, has, has, hasInstance, put, put, setParentScope, setPrototype

Constructor Detail

HTMLInputElement

public HTMLInputElement()

Creates an instance.

Method Detail

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 FormField

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

getChecked

public boolean getChecked()

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.

setAttribute

public void setAttribute(String name,
                String value)

Uses setType(String) if attribute's name is type to replace DOM node as well as long as we have subclasses of HtmlInput. Sets an attribute. See also the DOM reference

Overrides:

setAttribute in class HTMLElement

Parameters:

name - Name of the attribute to set

value - Value to set the attribute to

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

getDefaultChecked

public boolean getDefaultChecked()

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 int 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 int 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

getReadOnly

public boolean getReadOnly()

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

getBorder

public String getBorder()

Gets the border attribute.

Returns:

the border attribute

setBorder

public void setBorder(String border)

Sets the border attribute.

Parameters:

border - the border attribute

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

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

Returns:

the required attribute

setRequired

public void setRequired(boolean required)

Sets the required attribute.

Parameters:

required - the new attribute 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 Object 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.

Overrides:

getWidth in class HTMLElement

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.

Overrides:

getHeight in class HTMLElement

Returns:

the height property

setHeight

public void setHeight(int height)

Sets the height property.

Parameters:

height - the height property

getLabels

public AbstractList getLabels()

Returns the labels associated with the element.

Returns:

the labels associated with the element