All Implemented Interfaces:

Serializable, Cloneable, DisabledElement, FormFieldWithNameHistory, SubmittableElement, ValidatableElement, Element, Node

Direct Known Subclasses:

HtmlButtonInput, HtmlCheckBoxInput, HtmlColorInput, HtmlDateTimeLocalInput, HtmlFileInput, HtmlHiddenInput, HtmlImageInput, HtmlMonthInput, HtmlRadioButtonInput, HtmlRangeInput, HtmlResetInput, HtmlSelectableTextInput, HtmlSubmitInput, HtmlWeekInput

public abstract class HtmlInput
extends HtmlElement
implements DisabledElement, SubmittableElement, FormFieldWithNameHistory, ValidatableElement 

Author:

Mike Bowler, David K. Taylor, Christian Sell, David D. Kilzer, Marc Guillemot, Daniel Gredler, Ahmed Ashour, Ronald Brill, Frank Danek, Anton Demydenko, Ronny Shapiro

See Also:

Serialized Form

• Nested Class Summary

  • Nested classes/interfaces inherited from class org.htmlunit.html.HtmlElement

    HtmlElement.DisplayStyle

  • Nested classes/interfaces inherited from class org.htmlunit.html.DomElement

    DomElement.ChildElementsIterator

  • Nested classes/interfaces inherited from class org.htmlunit.html.DomNode

    DomNode.ChildIterator, DomNode.DescendantDomElementsIterator, DomNode.DescendantDomNodesIterator, DomNode.DescendantElementsIterator<T extends DomNode>, DomNode.DescendantHtmlElementsIterator

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static String	TAG_NAME The HTML tag represented by this element.

  • Fields inherited from class org.htmlunit.html.HtmlElement

    ATTRIBUTE_CHECKED, ATTRIBUTE_HIDDEN, ATTRIBUTE_REQUIRED, TAB_INDEX_OUT_OF_BOUNDS

  • Fields inherited from class org.htmlunit.html.DomElement

    ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY, ID_ATTRIBUTE, NAME_ATTRIBUTE, SRC_ATTRIBUTE, TYPE_ATTRIBUTE, VALUE_ATTRIBUTE

  • Fields inherited from class org.htmlunit.html.DomNode

    PROPERTY_ELEMENT, READY_STATE_COMPLETE, READY_STATE_INTERACTIVE, READY_STATE_LOADED, READY_STATE_LOADING, READY_STATE_UNINITIALIZED

  • Fields inherited from interface org.htmlunit.html.DisabledElement

    ATTRIBUTE_DISABLED

  • Fields inherited from interface org.w3c.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 and Description
  HtmlInput (SgmlPage page, Map<String,DomAttr> attributes) Creates an instance.
  HtmlInput (String qualifiedName, SgmlPage page, Map<String,DomAttr> attributes) Creates an instance.

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  protected void	adjustValueAfterTypeChange (HtmlInput oldInput, BrowserVersion browserVersion)
  HtmlInput	changeType (String newType, boolean setThroughAttribute) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  DomNode	cloneNode (boolean deep)
  void	focus () Sets the focus on this element.
  String	getAccept () Returns the value of the accept attribute.
  String	getAcceptAttribute () Returns the value of the attribute accept.
  String	getAccessKeyAttribute () Returns the value of the attribute accesskey.
  String	getAlignAttribute () Returns the value of the attribute align.
  String	getAltAttribute () Returns the value of the attribute alt.
  String	getAutocomplete () Returns the value of the autocomplete attribute.
  String	getCheckedAttribute () Returns the value of the attribute checked.
  HtmlElement.DisplayStyle	getDefaultStyleDisplay () INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  String	getDefaultValue () Returns the default value to use when this element gets reset, if applicable.
  String	getDisabledAttribute () Returns the value of the attribute disabled.
  protected Object	getInternalValue ()
  String	getMax () Returns the value of the max attribute.
  protected int	getMaxLength () Gets the max length if defined, Integer.MAX_VALUE if none.
  String	getMaxLengthAttribute () Returns the value of the attribute maxlength.
  String	getMin () Returns the value of the min attribute.
  protected int	getMinLength () Gets the min length if defined, Integer.MIN_VALUE if none.
  String	getMinLengthAttribute () Returns the value of the attribute minlength.
  String	getNameAttribute () Returns the value of the attribute name.
  Collection<String>	getNewNames () Get all the names this field got after the original one.
  String	getOnBlurAttribute () Returns the value of the attribute onblur.
  String	getOnChangeAttribute () Returns the value of the attribute onchange.
  String	getOnFocusAttribute () Returns the value of the attribute onfocus.
  String	getOnSelectAttribute () Returns the value of the attribute onselect.
  String	getOriginalName () Gets the first value of the name attribute of this field before any change.
  String	getPattern () Returns the value of the pattern attribute.
  String	getPlaceholder () Returns the value of the placeholder attribute.
  String	getRawValue () INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  String	getReadOnlyAttribute () Returns the value of the attribute readonly.
  String	getSize () Returns the value of the size attribute.
  String	getSizeAttribute () Returns the value of the attribute size.
  String	getSrc () Returns the value of the src value.
  String	getSrcAttribute () Returns the value of the attribute src.
  String	getStep () Returns the value of the step attribute.
  NameValuePair[]	getSubmitNameValuePairs () Returns an array of NameValuePairs that are the values that will be sent back to the server whenever this element's containing form is submitted.
  String	getTabIndexAttribute () Returns the value of the attribute tabindex.
  String	getType ()
  String	getTypeAttribute () Returns the value of the attribute type.
  String	getUseMapAttribute () Returns the value of the attribute usemap.
  String	getValue ()
  String	getValueAttribute () Return the value of the attribute "value".
  boolean	handles (Event event) Indicates if the provided event can be applied to this node.
  boolean	hasPatternMismatchValidityState ()
  protected boolean	isBlankPatternValidated ()
  boolean	isCheckable ()
  boolean	isChecked () Returns true if this element is currently selected.
  boolean	isCustomErrorValidityState ()
  protected boolean	isCustomValidityValid ()
  boolean	isDefaultChecked () Returns the default checked state to use when this element gets reset, if applicable.
  boolean	isDisabled () Returns true if the disabled attribute is set for this element.
  boolean	isFormNoValidate ()
  protected boolean	isMinMaxLengthSupported () Returns if the input element supports maxlength minlength validation.
  protected boolean	isPatternSupported () Returns if the input element supports pattern validation.
  boolean	isReadOnly () Returns true if this element is read only.
  protected boolean	isRequiredSupported () Returns whether this element supports the required constraint.
  boolean	isSubmitable ()
  boolean	isTooShortValidityState ()
  boolean	isValid () Returns whether this element satisfies all form validation constraints set.
  boolean	isValidValidityState ()
  boolean	isValueMissingValidityState ()
  protected void	markValueDirty ()
  protected boolean	propagateClickStateUpdateToParent () Usually the click is propagated to the parent.
  void	removeFocus () INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  void	reset () Returns the value of this element to the default value or checked state (usually what it was at the time the page was loaded, unless it has been modified via JavaScript).
  void	setAccept (String accept) Sets the accept attribute.
  protected void	setAttributeNS (String namespaceURI, String qualifiedName, String attributeValue, boolean notifyAttributeChangeListeners, boolean notifyMutationObservers) Sets the value of the attribute specified by namespace and qualified name.
  void	setAutocomplete (String autocomplete) Sets the autocomplete attribute.
  Page	setChecked (boolean isChecked) Sets the checked attribute, returning the page that occupies this input's window after setting the attribute.
  void	setCustomValidity (String message) Sets the custom validity message for the element to the specified message.
  void	setDefaultValue (String defaultValue) Sets the default value to use when this element gets reset, if applicable.
  void	setFormNoValidate (boolean noValidate) Sets the value of the attribute formnovalidate.
  void	setMax (String max) Sets the max attribute.
  void	setMaxLength (int maxLength) Sets the maxLength attribute.
  void	setMin (String min) Sets the min attribute.
  void	setMinLength (int minLength) Sets the minLength attribute.
  void	setPattern (String pattern) Sets the pattern attribute.
  void	setPlaceholder (String placeholder) Sets the placeholder attribute.
  void	setRawValue (String rawValue) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  void	setReadOnly (boolean isReadOnly) Sets the readOnly attribute.
  void	setSize (String size) Sets the size attribute.
  void	setSrcAttribute (String src) Sets the src attribute.
  void	setStep (String step) Sets the step attribute.
  void	setValue (String newValue) Sets the value.
  void	setValueAttribute (String newValue) Sets the content of the value attribute.
  protected void	unmarkValueDirty ()
  protected void	valueAttributeChanged (String attributeValue, boolean isValueDirty)
  void	valueModifiedByJavascript () INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
  boolean	willValidate ()

  • Methods inherited from class org.htmlunit.html.HtmlElement

    acceptChar, addHtmlAttributeChangeListener, appendChildIfNoneExists, checkChildHierarchy, detach, doType, doType, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, getCanonicalXPath, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getHidden, getLangAttribute, getNodeName, getOffsetLeft, getOffsetParentInternal, getOffsetTop, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getPosX, getPosY, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasEventHandlers, isAltPressed, isAttributeCaseSensitive, isCtrlPressed, isDisplayed, isHidden, isOptional, isRequired, isShiftPressed, isSubmittableByEnter, notifyAttributeChangeListeners, removeAttribute, removeChild, removeHtmlAttributeChangeListener, setAttributeNode, setHidden, setHidden, setOwningForm, setRequired, type, type, type, type, typeDone

  • Methods inherited from class org.htmlunit.html.DomElement

    blur, click, click, click, click, click, dblClick, dblClick, doClickFireChangeEvent, doClickFireClickEvent, doClickStateUpdate, fireEvent, fireEvent, getAttribute, getAttributeDirect, getAttributeNode, getAttributeNodeNS, getAttributeNS, getAttributes, getAttributesMap, getChildElementCount, getChildElements, getElementsByTagName, getElementsByTagNameNS, getEventTargetElement, getFirstElementChild, getId, getLastElementChild, getNodeType, getSchemaTypeInfo, getStaticElementsByTagName, getStyleElement, getStyleElementCaseInSensitive, getStyleMap, getTagName, hasAttribute, hasAttributeNS, hasAttributes, isDisabledElementAndDisabled, isEmptyXmlTagExpanded, isMouseOver, isStateUpdateFirst, matches, mouseDown, mouseDown, mouseMove, mouseMove, mouseOut, mouseOut, mouseOver, mouseOver, mouseUp, mouseUp, preventDefault, printOpeningTagContentAsXml, printXml, removeAttributeNode, removeAttributeNS, removeStyleAttribute, replaceStyleAttribute, rightClick, rightClick, setAttribute, setAttributeNodeNS, setAttributeNS, setDefaults, setId, setIdAttribute, setIdAttributeNode, setIdAttributeNS, setInnerHtml, setNodeValue, toString, writeStyleToElement

  • Methods inherited from class org.htmlunit.html.DomNamespaceNode

    getLocalName, getLowercaseName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix

  • Methods inherited from class org.htmlunit.html.DomNode

    addCharacterDataChangeListener, addDomChangeListener, appendChild, asNormalizedText, asXml, basicRemove, closest, compareDocumentPosition, fireCharacterDataChanged, fireNodeAdded, fireNodeDeleted, getAncestors, getBaseURI, getByXPath, getByXPath, getChildNodes, getChildren, getDescendants, getDomElementDescendants, getEndColumnNumber, getEndLineNumber, getFeature, getFirstByXPath, getFirstByXPath, getFirstChild, getHtmlElementDescendants, getHtmlPageOrNull, getIndex, getLastChild, getNextElementSibling, getNextSibling, getNodeValue, getOwnerDocument, getPage, getParentNode, getPreviousElementSibling, getPreviousSibling, getReadyState, getScriptableObject, getSelectorList, getStartColumnNumber, getStartLineNumber, getTextContent, getUserData, getVisibleText, hasChildNodes, hasFeature, insertBefore, insertBefore, isAncestorOf, isAncestorOfAny, isAttachedToPage, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, onAllChildrenAddedToPage, parseHtmlSnippet, printChildrenAsXml, querySelector, querySelectorAll, quietlyRemoveAndMoveChildrenTo, remove, removeAllChildren, removeCharacterDataChangeListener, removeChild, removeDomChangeListener, replace, replaceChild, setEndLocation, setParentNode, setReadyState, setScriptableObject, setStartLocation, setTextContent, setUserData

  • Methods inherited from class java.lang.Object

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

  • Methods inherited from interface org.htmlunit.html.SubmittableElement

    setDefaultChecked

  • Methods inherited from interface org.htmlunit.html.ValidatableElement

    hasBadInputValidityState, hasRangeOverflowValidityState, hasRangeUnderflowValidityState, hasTypeMismatchValidityState, isStepMismatchValidityState, isTooLongValidityState

  • Methods inherited from interface org.w3c.dom.Node

    appendChild, compareDocumentPosition, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setPrefix, setTextContent, setUserData

• Field Detail

  • TAG_NAME

    public static final String TAG_NAME

    The HTML tag represented by this element.

    See Also:

    Constant Field Values

• Constructor Detail

  • HtmlInput

    public HtmlInput(SgmlPage page,
     Map<String,DomAttr> attributes)

    Creates an instance.

    Parameters:

    page - the page that contains this element

    attributes - the initial attributes

  • HtmlInput

    public HtmlInput(String qualifiedName,
     SgmlPage page,
     Map<String,DomAttr> attributes)

    Creates an instance.

    Parameters:

    qualifiedName - the qualified name of the element type to instantiate

    page - the page that contains this element

    attributes - the initial attributes

• Method Detail

  • setValueAttribute

    public void setValueAttribute(String newValue)

    Sets the content of the value attribute.

    Parameters:

    newValue - the new value

  • getSubmitNameValuePairs

    public NameValuePair[] getSubmitNameValuePairs()

    Returns an array of NameValuePairs that are the values that will be sent back to the server whenever this element's containing form is submitted.

    THIS METHOD IS INTENDED FOR THE USE OF THE FRAMEWORK ONLY AND SHOULD NOT BE USED BY CONSUMERS OF HTMLUNIT. USE AT YOUR OWN RISK.

    Specified by:

    getSubmitNameValuePairs in interface SubmittableElement

    Returns:

    the values that will be sent back to the server whenever this element's containing form is submitted

  • getTypeAttribute

    public final String getTypeAttribute()

    Returns the value of the attribute type. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute type or an empty string if that attribute isn't defined

  • getNameAttribute

    public final String getNameAttribute()

    Returns the value of the attribute name. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute name or an empty string if that attribute isn't defined

  • getValueAttribute

    public final String getValueAttribute()

    Return the value of the attribute "value". Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute value or an empty string if that attribute isn't defined

  • getValue

    public String getValue()

    Returns:

    the value

  • setValue

    public void setValue(String newValue)

    Sets the value.

    Parameters:

    newValue - the new value

  • valueAttributeChanged

    protected void valueAttributeChanged(String attributeValue,
     boolean isValueDirty)

  • getCheckedAttribute

    public final String getCheckedAttribute()

    Returns the value of the attribute checked. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute checked or an empty string if that attribute isn't defined

  • getDisabledAttribute

    public final String getDisabledAttribute()

    Returns the value of the attribute disabled. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Specified by:

    getDisabledAttribute in interface DisabledElement

    Returns:

    the value of the attribute disabled or an empty string if that attribute isn't defined

  • isDisabled

    public final boolean isDisabled()

    Returns true if the disabled attribute is set for this element.

    Specified by:

    isDisabled in interface DisabledElement

    Returns:

    true if the disabled attribute is set for this element

  • getReadOnlyAttribute

    public final String getReadOnlyAttribute()

    Returns the value of the attribute readonly. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute readonly or an empty string if that attribute isn't defined.

  • getSizeAttribute

    public final String getSizeAttribute()

    Returns the value of the attribute size. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute size or an empty string if that attribute isn't defined.

  • getMaxLengthAttribute

    public final String getMaxLengthAttribute()

    Returns the value of the attribute maxlength. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute maxlength or an empty string if that attribute isn't defined.

  • getMaxLength

    protected int getMaxLength()

    Gets the max length if defined, Integer.MAX_VALUE if none.

    Returns:

    the max length

  • getMinLengthAttribute

    public final String getMinLengthAttribute()

    Returns the value of the attribute minlength. Refer to the HTML 5 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute minlength or an empty string if that attribute isn't defined.

  • getMinLength

    protected int getMinLength()

    Gets the min length if defined, Integer.MIN_VALUE if none.

    Returns:

    the min length

  • getSrcAttribute

    public String getSrcAttribute()

    Returns the value of the attribute src. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute src or an empty string if that attribute isn't defined.

  • getSrc

    public String getSrc()

    Returns the value of the src value.

    Returns:

    the value of the src value

  • setSrcAttribute

    public void setSrcAttribute(String src)

    Sets the src attribute.

    Parameters:

    src - the src attribute

  • getAltAttribute

    public final String getAltAttribute()

    Returns the value of the attribute alt. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute alt or an empty string if that attribute isn't defined.

  • getUseMapAttribute

    public final String getUseMapAttribute()

    Returns the value of the attribute usemap. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute usemap or an empty string if that attribute isn't defined.

  • getTabIndexAttribute

    public final String getTabIndexAttribute()

    Returns the value of the attribute tabindex. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute tabindex or an empty string if that attribute isn't defined.

  • getAccessKeyAttribute

    public final String getAccessKeyAttribute()

    Returns the value of the attribute accesskey. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute accesskey or an empty string if that attribute isn't defined.

  • getOnFocusAttribute

    public final String getOnFocusAttribute()

    Returns the value of the attribute onfocus. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute onfocus or an empty string if that attribute isn't defined.

  • getOnBlurAttribute

    public final String getOnBlurAttribute()

    Returns the value of the attribute onblur. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute onblur or an empty string if that attribute isn't defined.

  • getOnSelectAttribute

    public final String getOnSelectAttribute()

    Returns the value of the attribute onselect. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute onselect or an empty string if that attribute isn't defined.

  • getOnChangeAttribute

    public final String getOnChangeAttribute()

    Returns the value of the attribute onchange. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute onchange or an empty string if that attribute isn't defined.

  • getAcceptAttribute

    public final String getAcceptAttribute()

    Returns the value of the attribute accept. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute accept or an empty string if that attribute isn't defined.

  • getAlignAttribute

    public final String getAlignAttribute()

    Returns the value of the attribute align. Refer to the HTML 4.01 documentation for details on the use of this attribute.

    Returns:

    the value of the attribute align or an empty string if that attribute isn't defined.

  • reset

    public void reset()

    Returns the value of this element to the default value or checked state (usually what it was at the time the page was loaded, unless it has been modified via JavaScript).

    Specified by:

    reset in interface SubmittableElement

    See Also:

    SubmittableElement.reset()

  • setDefaultValue

    public void setDefaultValue(String defaultValue)

    Sets the default value to use when this element gets reset, if applicable.

    Specified by:

    setDefaultValue in interface SubmittableElement

    Parameters:

    defaultValue - the default value to use when this element gets reset, if applicable

    See Also:

    SubmittableElement.setDefaultValue(String)

  • getDefaultValue

    public String getDefaultValue()

    Returns the default value to use when this element gets reset, if applicable.

    Specified by:

    getDefaultValue in interface SubmittableElement

    Returns:

    the default value to use when this element gets reset, if applicable

    See Also:

    SubmittableElement.getDefaultValue()

  • getRawValue

    public String getRawValue()

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    

    Returns:

    the raw value

  • setRawValue

    public void setRawValue(String rawValue)

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    Update the raw value.

    Parameters:

    rawValue - the new raw value

  • isDefaultChecked

    public boolean isDefaultChecked()

    Returns the default checked state to use when this element gets reset, if applicable. The default implementation returns false; only checkboxes and radio buttons really care what the default checked value is.

    Specified by:

    isDefaultChecked in interface SubmittableElement

    Returns:

    the default checked state to use when this element gets reset, if applicable

    See Also:

    SubmittableElement.isDefaultChecked(), HtmlRadioButtonInput.isDefaultChecked(), HtmlCheckBoxInput.isDefaultChecked()

  • setChecked

    public Page setChecked(boolean isChecked)

    Sets the checked attribute, returning the page that occupies this input's window after setting the attribute. Note that the returned page may or may not be the original page, depending on the presence of JavaScript event handlers, etc.

    Parameters:

    isChecked - true if this element is to be selected

    Returns:

    the page that occupies this input's window after setting the attribute

  • setReadOnly

    public void setReadOnly(boolean isReadOnly)

    Sets the readOnly attribute.

    Parameters:

    isReadOnly - true if this element is read only

  • isChecked

    public boolean isChecked()

    Returns true if this element is currently selected.

    Returns:

    true if this element is currently selected

  • isReadOnly

    public boolean isReadOnly()

    Returns true if this element is read only.

    Returns:

    true if this element is read only

  • propagateClickStateUpdateToParent

    protected boolean propagateClickStateUpdateToParent()

    Usually the click is propagated to the parent. Overwrite if you like to disable this.

    Overrides:

    propagateClickStateUpdateToParent in class DomElement

    Returns:

    true or false

    See Also:

    DomElement.doClickStateUpdate(boolean, boolean)

  • handles

    public boolean handles(Event event)

    Indicates if the provided event can be applied to this node. Overwrite this.

    Overrides:

    handles in class HtmlElement

    Parameters:

    event - the event

    Returns:

    false if the event can't be applied

  • setAttributeNS

    protected void setAttributeNS(String namespaceURI,
     String qualifiedName,
     String attributeValue,
     boolean notifyAttributeChangeListeners,
     boolean notifyMutationObservers)

    Sets the value of the attribute specified by namespace and qualified name.

    Overrides:

    setAttributeNS in class HtmlElement

    Parameters:

    namespaceURI - the URI that identifies an XML namespace

    qualifiedName - the qualified name (prefix:local) of the attribute

    attributeValue - the value of the attribute

    notifyAttributeChangeListeners - to notify the associated HtmlAttributeChangeListeners

    notifyMutationObservers - to notify MutationObservers or not

  • getOriginalName

    public String getOriginalName()

    Gets the first value of the name attribute of this field before any change.

    Specified by:

    getOriginalName in interface FormFieldWithNameHistory

    Returns:

    the original name (which is the same as the current one when no change has been made)

  • getNewNames

    public Collection<String> getNewNames()

    Get all the names this field got after the original one.

    Specified by:

    getNewNames in interface FormFieldWithNameHistory

    Returns:

    an empty collection if the name attribute has never been changed.

  • valueModifiedByJavascript

    public void valueModifiedByJavascript()

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    Marks this element as modified (value) by javascript. This is needed to support maxlength/minlength validation.

  • focus

    public final void focus()

    Sets the focus on this element.

    Overrides:

    focus in class DomElement

  • removeFocus

    public final void removeFocus()

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    Gets notified that it has lost the focus.

    Overrides:

    removeFocus in class DomElement

  • getInternalValue

    protected Object getInternalValue()

    Returns:

    returns the raw value

  • getDefaultStyleDisplay

    public HtmlElement.DisplayStyle getDefaultStyleDisplay()

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    Returns the default display style.

    Overrides:

    getDefaultStyleDisplay in class HtmlElement

    Returns:

    the default display style

  • getSize

    public String getSize()

    Returns the value of the size attribute.

    Returns:

    the value of the size attribute

  • setSize

    public void setSize(String size)

    Sets the size attribute.

    Parameters:

    size - the size attribute

  • setMaxLength

    public void setMaxLength(int maxLength)

    Sets the maxLength attribute.

    Parameters:

    maxLength - the maxLength attribute

  • setMinLength

    public void setMinLength(int minLength)

    Sets the minLength attribute.

    Parameters:

    minLength - the minLength attribute

  • getAccept

    public String getAccept()

    Returns the value of the accept attribute.

    Returns:

    the value of the accept attribute

  • setAccept

    public void setAccept(String accept)

    Sets the accept attribute.

    Parameters:

    accept - the accept attribute

  • getAutocomplete

    public String getAutocomplete()

    Returns the value of the autocomplete attribute.

    Returns:

    the value of the autocomplete attribute

  • setAutocomplete

    public void setAutocomplete(String autocomplete)

    Sets the autocomplete attribute.

    Parameters:

    autocomplete - the autocomplete attribute

  • getPlaceholder

    public String getPlaceholder()

    Returns the value of the placeholder attribute.

    Returns:

    the value of the placeholder attribute

  • setPlaceholder

    public void setPlaceholder(String placeholder)

    Sets the placeholder attribute.

    Parameters:

    placeholder - the placeholder attribute

  • getPattern

    public String getPattern()

    Returns the value of the pattern attribute.

    Returns:

    the value of the pattern attribute

  • setPattern

    public void setPattern(String pattern)

    Sets the pattern attribute.

    Parameters:

    pattern - the pattern attribute

  • getMin

    public String getMin()

    Returns the value of the min attribute.

    Returns:

    the value of the min attribute

  • setMin

    public void setMin(String min)

    Sets the min attribute.

    Parameters:

    min - the min attribute

  • getMax

    public String getMax()

    Returns the value of the max attribute.

    Returns:

    the value of the max attribute

  • setMax

    public void setMax(String max)

    Sets the max attribute.

    Parameters:

    max - the max attribute

  • getStep

    public String getStep()

    Returns the value of the step attribute.

    Returns:

    the value of the step attribute

  • setStep

    public void setStep(String step)

    Sets the step attribute.

    Parameters:

    step - the step attribute

  • isValid

    public boolean isValid()

    Description copied from class: HtmlElement
    Returns whether this element satisfies all form validation constraints set.

    Overrides:

    isValid in class HtmlElement

    Returns:

    whether this element satisfies all form validation constraints set

  • isCustomValidityValid

    protected boolean isCustomValidityValid()

  • isRequiredSupported

    protected boolean isRequiredSupported()

    Description copied from class: HtmlElement
    Returns whether this element supports the required constraint.

    Overrides:

    isRequiredSupported in class HtmlElement

    Returns:

    whether this element supports the required constraint

  • isPatternSupported

    protected boolean isPatternSupported()

    Returns if the input element supports pattern validation. Refer to the HTML 5 documentation for details.

    Returns:

    if the input element supports pattern validation

  • isBlankPatternValidated

    protected boolean isBlankPatternValidated()

    Returns:

    if the element executes pattern validation on blank strings

  • isMinMaxLengthSupported

    protected boolean isMinMaxLengthSupported()

    Returns if the input element supports maxlength minlength validation. Refer to the HTML 5 documentation for details.

    Returns:

    if the input element supports pattern validation

  • cloneNode

    public DomNode cloneNode(boolean deep)

    Specified by:

    cloneNode in interface Node

    Overrides:

    cloneNode in class HtmlElement

  • willValidate

    public boolean willValidate()

    Specified by:

    willValidate in interface ValidatableElement

    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.

    Specified by:

    setCustomValidity in interface ValidatableElement

    Parameters:

    message - the new message

  • isCheckable

    public boolean isCheckable()

    Returns:

    whether this is a checkbox or a radio button

  • isSubmitable

    public boolean isSubmitable()

    Returns:

    false for type submit/resest/image/button otherwise true

  • isCustomErrorValidityState

    public boolean isCustomErrorValidityState()

    Specified by:

    isCustomErrorValidityState in interface ValidatableElement

    Returns:

    a boolean value indicating whether the element's custom validity message has been set to a non-empty string by calling the element's setCustomValidity() method.

  • hasPatternMismatchValidityState

    public boolean hasPatternMismatchValidityState()

    Specified by:

    hasPatternMismatchValidityState in interface ValidatableElement

    Returns:

    true if the value does not match the specified pattern, and false if it does match. If true, the element matches the :invalid CSS pseudo-class

  • isTooShortValidityState

    public boolean isTooShortValidityState()

    Specified by:

    isTooShortValidityState in interface ValidatableElement

    Returns:

    true if the value is shorter than the minimum length specified by the minlength attribute, or false if it is greater than or equal to the minimum. If true, the element matches the :invalid CSS pseudo-class

  • isValidValidityState

    public boolean isValidValidityState()

    Specified by:

    isValidValidityState in interface ValidatableElement

    Returns:

    true if the element meets all its validation constraints, and is therefore considered to be valid, or false if it fails any constraint. If true, the element matches the :valid CSS pseudo-class; the :invalid CSS pseudo-class otherwise.

  • isValueMissingValidityState

    public boolean isValueMissingValidityState()

    Specified by:

    isValueMissingValidityState in interface ValidatableElement

    Returns:

    true if the element has a required attribute, but no value, or false otherwise. If true, the element matches the :invalid CSS pseudo-class.

  • isFormNoValidate

    public final boolean isFormNoValidate()

    Returns:

    the value of the attribute formnovalidate or an empty string if that attribute isn't defined

  • setFormNoValidate

    public final void setFormNoValidate(boolean noValidate)

    Sets the value of the attribute formnovalidate.

    Parameters:

    noValidate - the value of the attribute formnovalidate

  • getType

    public final String getType()

    Returns:

    the type property

  • changeType

    public HtmlInput changeType(String newType,
     boolean setThroughAttribute)

    INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
    Changes the type of the current HtmlInput. Because there are several subclasses of HtmlInput, changing the type attribute is not sufficient, this will replace the HtmlInput element in the DOM tree with a new one (at least of the newType is different from the old one).
    The js peer object is still the same (there is only a HTMLInputElement without any sublcasses).
    This returns the new (or the old) HtmlInput element to ease the use of this method.

    Parameters:

    newType - the new type to set

    setThroughAttribute - set type value through setAttribute()

    Returns:

    the new or the old HtmlInput element

  • adjustValueAfterTypeChange

    protected void adjustValueAfterTypeChange(HtmlInput oldInput,
     BrowserVersion browserVersion)

  • unmarkValueDirty

    protected void unmarkValueDirty()

  • markValueDirty

    protected void markValueDirty()