com.gargoylesoftware.htmlunit.javascript.host.html

Class HTMLInputElement

java.lang.Object

net.sourceforge.htmlunit.corejs.javascript.ScriptableObject

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 form input elements (html tag <input ...>).

Version:

$Revision: 10305 $

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.
int	getMaxLength() Gets the max length.
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 value of the JavaScript attribute "type".
protected boolean	isAttributeName(String name) Indicates if this is the name of a well defined attribute that can be access as 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	setMaxLength(int length) Sets the value of "maxLength" 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".

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

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

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, createEventHandler, createTextRange, dispatchEvent, doComponentRequest, doScroll, fixAttributeName, focus, get, getAccessKey, getAlign, getAll, getAttributeNode, getAttributeNodeNS, getAvailHeight, getAvailWidth, getBoundingClientRect, getBoxObject, getBufferDepth, getCh, getChildren, getChOff, getClassList, getClassName_js, getClientHeight, getClientLeft, getClientRects, getClientTop, getClientWidth, getColorDepth, getComponentVersion, getConnectionType, getCookieEnabled, getCpuClass, getDataset, getDefaultStyleDisplay, getDir, getDocument, getDomNodeOrNull, getElementsByClassName, getFilters, getHeight, getId, getInnerHTML, getInnerText, getJavaEnabled, getLang, getLanguage, getLocalName, getNodeName, getOffsetHeight, getOffsetLeft, getOffsetParent_js, getOffsetTop, getOffsetWidth, getOnsubmit, getOuterHTML, getParentElement, getParentHTMLElement, getPlatform, getPosX, getPosY, getPrefix, getScopeName, getScrollHeight, getScrollLeft, getScrollTop, getScrollWidth, getSpellcheck, getSystemLanguage, getTabIndex, getTagUrn, getTitle, getUniqueID, getUserLanguage, getVAlign, getWidth, getWidthOrHeight, getWithFallback, hasAttribute, insertAdjacentElement, insertAdjacentHTML, insertAdjacentText, isAncestorOfEventTarget, isComponentInstalled, isHomePage, isLowerCaseInOuterHtml, mergeAttributes, navigateHomePage, parseHtmlSnippet, querySelector, querySelectorAll, readAttributes, releaseCapture, removeAttributeNode, removeBehavior, removeExpression, removeNode, scrollIntoView, setAccessKey, setActive, setAlign, setCapture, setCh, setChOff, setClassName_js, setColorAttribute, setDir, setExpression, 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, getAttribute, getAttributeNS, getAttributes, getBaseURI, getChildElementCount, getCurrentStyle, getElementsByTagName, getElementsByTagNameNS, getFirstElementChild, getLastElementChild, getNextElementSibling, getPreviousElementSibling, getRuntimeStyle, getStyle, getTagName, getText, hasAttributeNS, removeAttribute, removeAttributeNS, selectNodes, selectSingleNode, setAttributeNode, setAttributeNS, setDefaults

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

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

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

addEventListener, appendChild, asJavaScriptException, attachEvent, cloneNode, compareDocumentPosition, contains, detachEvent, executeEvent, fireEvent, fireEvent, getBaseName, getChildNodes, getEventHandler, getEventHandlerProp, getFirstChild, getJavaScriptNode, getLastChild, getNamespaceURI, getNextSibling, getNodeType, getNodeValue, getOwnerDocument, getParent, getParentNode, getPreviousSibling, getTextContent, getXml, hasChildNodes, hasEventHandlers, insertBefore, insertBeforeImpl, isSameNode, normalize, removeChild, removeEventListener, replaceChild, setEventHandler, setEventHandlerProp, setNodeValue

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

clone, defineFunctionProperties, defineProperty, equivalentValues, getBrowserVersion, getClassName, getDefaultValue, getPrototype, getScriptableFor, getStartingScope, getTransformerScriptableFor, getWindow, getWindow, getWithPreemption, hasInstance, initParentScope, isReadOnlySettable, makeScriptableFor, setCaseSensitive, setClassName, setDomNode, setHtmlElement, 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, 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, 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, getClassName, getDefaultValue, getIds, getParentScope, getPrototype, has, has, hasInstance, put, put, setParentScope, setPrototype

Constructor Detail

HTMLInputElement

public HTMLInputElement()

Creates an instance.

Method Detail

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

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

isAttributeName

protected boolean isAttributeName(String name)

Indicates if this is the name of a well defined attribute that can be access as property. Ex: for HtmlInputElement maxlength => false but maxLength => true

Overrides:

isAttributeName in class HTMLElement

Parameters:

name - the name (case sensitive!)

Returns:

false if no standard attribute exists with this name

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

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. Overridden to modify browser configurations.

Overrides:

click in class HTMLElement

Throws:

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

getType

public String getType()

Returns the value of the JavaScript attribute "type". Overridden to modify browser configurations.

Overrides:

getType in class FormField

Returns:

the value of this attribute

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