public abstract class HtmlInput extends HtmlElement implements DisabledElement, SubmittableElement, FormFieldWithNameHistory
HtmlElement.DisplayStyleDomElement.ChildElementsIteratorDomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>| Modifier and Type | Field and Description |
|---|---|
static String |
TAG_NAME
The HTML tag represented by this element.
|
TAB_INDEX_OUT_OF_BOUNDSATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY, SRC_ATTRIBUTEAS_TEXT_BLANK, AS_TEXT_BLOCK_SEPARATOR, AS_TEXT_NEW_LINE, AS_TEXT_TAB, PROPERTY_ELEMENT, READY_STATE_COMPLETE, READY_STATE_INTERACTIVE, READY_STATE_LOADED, READY_STATE_LOADING, READY_STATE_UNINITIALIZEDATTRIBUTE_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 and Description |
|---|
HtmlInput(SgmlPage page,
Map<String,DomAttr> attributes)
Creates an instance.
|
HtmlInput(String qualifiedName,
SgmlPage page,
Map<String,DomAttr> attributes)
Creates an instance.
|
| Modifier and Type | Method and Description |
|---|---|
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 int |
getMaxLength()
Gets the max length if defined, Integer.MAX_VALUE if none.
|
String |
getMaxLengthAttribute()
Returns the value of the attribute
maxlength. |
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 |
getPlaceholder()
Returns the value of the
placeholder attribute. |
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 |
getSrcAttribute()
Returns the value of the attribute
src. |
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 |
getTypeAttribute()
Returns the value of the attribute
type. |
String |
getUseMapAttribute()
Returns the value of the attribute
usemap. |
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 |
isChecked()
Returns
true if this element is currently selected. |
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 |
isReadOnly()
Returns
true if this element is read only. |
protected boolean |
isRequiredSupported()
Returns whether this element supports the
required constraint. |
void |
markAsCreatedByJavascript()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
protected boolean |
propagateClickStateUpdateToParent() |
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. |
void |
setAttribute(String attributeName,
String attributeValue)
Sets the value of the attribute specified by name.
|
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 |
setDefaultValue(String defaultValue)
Sets the default value to use when this element gets reset, if applicable.
|
protected void |
setDefaultValue(String defaultValue,
boolean modifyValue)
Sets the default value, optionally also modifying the current value.
|
void |
setMaxLength(int maxLength)
Sets the
maxLength attribute. |
void |
setMinLength(int minLength)
Sets the
minLength attribute. |
void |
setPlaceholder(String placeholder)
Sets the
placeholder attribute. |
void |
setReadOnly(boolean isReadOnly)
Sets the
readOnly attribute. |
void |
setSize(String size)
Sets the
size attribute. |
void |
setValueAttribute(String newValue)
Sets the content of the
value attribute. |
boolean |
wasCreatedByJavascript()
INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
|
acceptChar, addHtmlAttributeChangeListener, appendChildIfNoneExists, checkChildHierarchy, detach, doType, doType, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, getCanonicalXPath, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, hasEventHandlers, isAltPressed, isAttributeCaseSensitive, isCtrlPressed, isDisplayed, isRequired, isShiftPressed, isSubmittableByEnter, isValid, notifyAttributeChangeListeners, removeAttribute, removeChild, removeHtmlAttributeChangeListener, setAttributeNode, setRequired, type, type, type, type, typeDoneblur, 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, 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, setAttributeNodeNS, setAttributeNS, setId, setIdAttribute, setIdAttributeNode, setIdAttributeNS, setNodeValue, toString, writeStyleToElementgetLocalName, getLowercaseName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefixaddCharacterDataChangeListener, addDomChangeListener, appendChild, asText, asXml, basicRemove, 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, hasChildNodes, hasFeature, insertBefore, insertBefore, isAncestorOf, isAncestorOfAny, isAttachedToPage, isDefaultNamespace, isEqualNode, isSameNode, isSupported, isTrimmedText, lookupNamespaceURI, lookupPrefix, mayBeDisplayed, normalize, notifyIncorrectness, onAddedToDocumentFragment, onAddedToPage, onAllChildrenAddedToPage, printChildrenAsXml, querySelector, querySelectorAll, remove, removeAllChildren, removeCharacterDataChangeListener, removeChild, removeDomChangeListener, replace, replaceChild, setNextSibling, setParentNode, setPreviousSibling, setReadyState, setScriptableObject, setTextContent, setUserDataclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitsetDefaultCheckedappendChild, 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, setUserDatapublic static final String TAG_NAME
public HtmlInput(SgmlPage page, Map<String,DomAttr> attributes)
page - the page that contains this elementattributes - the initial attributespublic void setAttribute(String attributeName, String attributeValue)
setAttribute in interface ElementsetAttribute in class DomElementattributeName - the name of the attributeattributeValue - the value of the attributepublic void setValueAttribute(String newValue)
value attribute.newValue - the new valuepublic 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.
getSubmitNameValuePairs in interface SubmittableElementpublic final String getTypeAttribute()
type. Refer to the
HTML 4.01
documentation for details on the use of this attribute.type or an empty string if that attribute isn't definedpublic final String getNameAttribute()
name. Refer to the
HTML 4.01
documentation for details on the use of this attribute.name or an empty string if that attribute isn't definedpublic 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.
value or an empty string if that attribute isn't definedpublic final String getCheckedAttribute()
checked. Refer to the
HTML 4.01
documentation for details on the use of this attribute.checked or an empty string if that attribute isn't definedpublic final String getDisabledAttribute()
disabled. Refer to the
HTML 4.01
documentation for details on the use of this attribute.getDisabledAttribute in interface DisabledElementdisabled or an empty string if that attribute isn't definedpublic final boolean isDisabled()
true if the disabled attribute is set for this element.isDisabled in interface DisabledElementtrue if the disabled attribute is set for this elementpublic final String getReadOnlyAttribute()
readonly. Refer to the
HTML 4.01
documentation for details on the use of this attribute.readonly
or an empty string if that attribute isn't defined.public final String getSizeAttribute()
size. Refer to the
HTML 4.01
documentation for details on the use of this attribute.size
or an empty string if that attribute isn't defined.public final String getMaxLengthAttribute()
maxlength. Refer to the
HTML 4.01
documentation for details on the use of this attribute.maxlength
or an empty string if that attribute isn't defined.protected int getMaxLength()
public final String getSrcAttribute()
src. Refer to the
HTML 4.01
documentation for details on the use of this attribute.src
or an empty string if that attribute isn't defined.public final String getAltAttribute()
alt. Refer to the
HTML 4.01
documentation for details on the use of this attribute.alt
or an empty string if that attribute isn't defined.public final String getUseMapAttribute()
usemap. Refer to the
HTML 4.01
documentation for details on the use of this attribute.usemap
or an empty string if that attribute isn't defined.public final String getTabIndexAttribute()
tabindex. Refer to the
HTML 4.01
documentation for details on the use of this attribute.tabindex
or an empty string if that attribute isn't defined.public final String getAccessKeyAttribute()
accesskey. Refer to the
HTML 4.01
documentation for details on the use of this attribute.accesskey
or an empty string if that attribute isn't defined.public final String getOnFocusAttribute()
onfocus. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onfocus
or an empty string if that attribute isn't defined.public final String getOnBlurAttribute()
onblur. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onblur
or an empty string if that attribute isn't defined.public final String getOnSelectAttribute()
onselect. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onselect
or an empty string if that attribute isn't defined.public final String getOnChangeAttribute()
onchange. Refer to the
HTML 4.01
documentation for details on the use of this attribute.onchange
or an empty string if that attribute isn't defined.public final String getAcceptAttribute()
accept. Refer to the
HTML 4.01
documentation for details on the use of this attribute.accept
or an empty string if that attribute isn't defined.public final String getAlignAttribute()
align. Refer to the
HTML 4.01
documentation for details on the use of this attribute.align
or an empty string if that attribute isn't defined.public void reset()
reset in interface SubmittableElementSubmittableElement.reset()public void setDefaultValue(String defaultValue)
setDefaultValue in interface SubmittableElementdefaultValue - the default value to use when this element gets reset, if applicableSubmittableElement.setDefaultValue(String)protected void setDefaultValue(String defaultValue, boolean modifyValue)
defaultValue - the new default valuemodifyValue - Whether or not to set the current value to the default valuepublic String getDefaultValue()
getDefaultValue in interface SubmittableElementSubmittableElement.getDefaultValue()public boolean isDefaultChecked()
false; only checkboxes and
radio buttons really care what the default checked value is.isDefaultChecked in interface SubmittableElementSubmittableElement.isDefaultChecked(),
HtmlRadioButtonInput.isDefaultChecked(),
HtmlCheckBoxInput.isDefaultChecked()public Page setChecked(boolean isChecked)
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.isChecked - true if this element is to be selectedpublic void setReadOnly(boolean isReadOnly)
readOnly attribute.isReadOnly - true if this element is read onlypublic boolean isChecked()
true if this element is currently selected.true if this element is currently selectedpublic boolean isReadOnly()
true if this element is read only.true if this element is read onlyprotected boolean propagateClickStateUpdateToParent()
propagateClickStateUpdateToParent in class DomElementUsually the click is propagated to the parent. Overwrite if you
like to disable this.public boolean handles(Event event)
handles in class HtmlElementevent - the eventfalse if the event can't be appliedprotected void setAttributeNS(String namespaceURI, String qualifiedName, String attributeValue, boolean notifyAttributeChangeListeners, boolean notifyMutationObservers)
setAttributeNS in class HtmlElementnamespaceURI - the URI that identifies an XML namespacequalifiedName - the qualified name (prefix:local) of the attributeattributeValue - the value of the attributenotifyAttributeChangeListeners - to notify the associated HtmlAttributeChangeListenersnotifyMutationObservers - to notify MutationObservers or notpublic String getOriginalName()
name attribute of this field before any change.getOriginalName in interface FormFieldWithNameHistorypublic Collection<String> getNewNames()
getNewNames in interface FormFieldWithNameHistorypublic void markAsCreatedByJavascript()
public boolean wasCreatedByJavascript()
public final void focus()
focus in class DomElementpublic final void removeFocus()
removeFocus in class DomElementpublic HtmlElement.DisplayStyle getDefaultStyleDisplay()
getDefaultStyleDisplay in class HtmlElementpublic String getSize()
size attribute.size attributepublic void setSize(String size)
size attribute.size - the size attributepublic void setMaxLength(int maxLength)
maxLength attribute.maxLength - the maxLength attributepublic void setMinLength(int minLength)
minLength attribute.minLength - the minLength attributepublic String getAccept()
accept attribute.accept attributepublic void setAccept(String accept)
accept attribute.accept - the accept attributepublic String getAutocomplete()
autocomplete attribute.autocomplete attributepublic void setAutocomplete(String autocomplete)
autocomplete attribute.autocomplete - the autocomplete attributepublic String getPlaceholder()
placeholder attribute.placeholder attributepublic void setPlaceholder(String placeholder)
placeholder attribute.placeholder - the placeholder attributeprotected boolean isRequiredSupported()
required constraint.isRequiredSupported in class HtmlElementrequired constraintpublic DomNode cloneNode(boolean deep)
cloneNode in interface NodecloneNode in class HtmlElementCopyright © 2002–2019 Gargoyle Software Inc.. All rights reserved.