com.gargoylesoftware.htmlunit.html

Class HtmlForm

java.lang.Object

com.gargoylesoftware.htmlunit.html.DomNode

com.gargoylesoftware.htmlunit.html.DomNamespaceNode

com.gargoylesoftware.htmlunit.html.DomElement

com.gargoylesoftware.htmlunit.html.HtmlElement

com.gargoylesoftware.htmlunit.html.HtmlForm

All Implemented Interfaces:

Serializable, Cloneable, Element, Node

public class HtmlForm
extends HtmlElement

Wrapper for the HTML element "form".

Author:

Mike Bowler, David K. Taylor, Brad Clarke, Christian Sell, Marc Guillemot, George Murnock, Kent Tong, Ahmed Ashour, Philip Graf, Ronald Brill, Frank Danek

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.html.HtmlElement

HtmlElement.DisplayStyle

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.html.DomElement

DomElement.ChildElementsIterator

Nested classes/interfaces inherited from class com.gargoylesoftware.htmlunit.html.DomNode

DomNode.ChildIterator, DomNode.DescendantElementsIterator<T extends DomNode>

Field Summary

Fields

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

Fields inherited from class com.gargoylesoftware.htmlunit.html.HtmlElement

TAB_INDEX_OUT_OF_BOUNDS

Fields inherited from class com.gargoylesoftware.htmlunit.html.DomElement

ATTRIBUTE_NOT_DEFINED, ATTRIBUTE_VALUE_EMPTY

Fields inherited from class com.gargoylesoftware.htmlunit.html.DomNode

AS_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_UNINITIALIZED

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

Method Summary

Modifier and Type	Method and Description
String	getAcceptAttribute() Returns the value of the attribute accept.
String	getAcceptCharsetAttribute() Returns the value of the attribute accept-charset.
String	getActionAttribute() Returns the value of the attribute action.
HtmlButton	getButtonByName(String name) Returns the first HtmlButton element in this form that has the specified name.
List<HtmlButton>	getButtonsByName(String name) Returns all the HtmlButton elements in this form that have the specified name.
HtmlRadioButtonInput	getCheckedRadioButton(String name) Returns the first checked radio button with the specified name.
String	getEnctypeAttribute() Returns the value of the attribute enctype.
<I extends HtmlInput> I	getInputByName(String name) Returns the first input element which is a member of this form and has the specified name.
<I extends HtmlInput> I	getInputByValue(String value) Returns the first input in this form with the specified value.
List<HtmlInput>	getInputsByName(String name) Returns all input elements which are members of this form and have the specified name.
List<HtmlInput>	getInputsByValue(String value) Returns all the inputs in this form with the specified value.
List<HtmlElement>	getLostChildren() Gets the form elements that may be submitted but that don't belong to the form's children in the DOM due to incorrect HTML code.
String	getMethodAttribute() Returns the value of the attribute method.
String	getNameAttribute() Returns the value of the attribute name.
String	getOnResetAttribute() Returns the value of the attribute onreset.
String	getOnSubmitAttribute() Returns the value of the attribute onsubmit.
List<NameValuePair>	getParameterListForSubmit(SubmittableElement submitElement) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Returns a list of NameValuePairs that represent the data that will be sent to the server when this form is submitted.
List<HtmlRadioButtonInput>	getRadioButtonsByName(String name) Returns all the HtmlRadioButtonInput elements in this form that have the specified name.
HtmlSelect	getSelectByName(String name) Returns the first HtmlSelect element in this form that has the specified name.
List<HtmlSelect>	getSelectsByName(String name) Returns all the HtmlSelect elements in this form that have the specified name.
String	getTargetAttribute() Returns the value of the attribute target.
HtmlTextArea	getTextAreaByName(String name) Returns the first HtmlTextArea element in this form that has the specified name.
List<HtmlTextArea>	getTextAreasByName(String name) Returns all the HtmlTextArea elements in this form that have the specified name.
WebRequest	getWebRequest(SubmittableElement submitElement) INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK. Gets the request for a submission of this form with the specified SubmittableElement.
protected boolean	isEmptyXmlTagExpanded() Browsers have problems with self closing form tags.
protected void	preventDefault() This method is called if the current fired event is canceled by preventDefault() in FireFox, or by returning false in Internet Explorer.
Page	reset() Resets this form to its initial values, returning the page contained by this form's window after the reset.
void	setActionAttribute(String action) Sets the value of the attribute action.
void	setEnctypeAttribute(String encoding) Sets the value of the attribute enctype.
void	setMethodAttribute(String method) Sets the value of the attribute method.
void	setNameAttribute(String name) Sets the value of the attribute name.
void	setTargetAttribute(String target) Sets the value of the attribute target.

Methods inherited from class com.gargoylesoftware.htmlunit.html.HtmlElement

acceptChar, addHtmlAttributeChangeListener, appendChildIfNoneExists, checkChildHierarchy, detach, doType, doType, fireHtmlAttributeAdded, fireHtmlAttributeRemoved, fireHtmlAttributeReplaced, getCanonicalXPath, getDefaultStyleDisplay, getElementsByAttribute, getEnclosingElement, getEnclosingForm, getEnclosingFormOrDie, getLangAttribute, getNodeName, getOnClickAttribute, getOnDblClickAttribute, getOneHtmlElementByAttribute, getOnKeyDownAttribute, getOnKeyPressAttribute, getOnKeyUpAttribute, getOnMouseDownAttribute, getOnMouseMoveAttribute, getOnMouseOutAttribute, getOnMouseOverAttribute, getOnMouseUpAttribute, getSrcAttributeNormalized, getTabIndex, getTextDirectionAttribute, getXmlLangAttribute, handles, hasEventHandlers, isAltPressed, isAttributeCaseSensitive, isCtrlPressed, isDisplayed, isRequired, isRequiredSupported, isShiftPressed, isSubmittableByEnter, isValid, notifyAttributeChangeListeners, removeAttribute, removeChild, removeHtmlAttributeChangeListener, setAttributeNode, setAttributeNS, setRequired, type, type, type, type, typeDone

Methods inherited from class com.gargoylesoftware.htmlunit.html.DomElement

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

Methods inherited from class com.gargoylesoftware.htmlunit.html.DomNamespaceNode

getLocalName, getNamespaceURI, getPrefix, getQualifiedName, processImportNode, setPrefix

Methods inherited from class com.gargoylesoftware.htmlunit.html.DomNode

addCharacterDataChangeListener, 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, setNodeValue, setParentNode, setPreviousSibling, setReadyState, setScriptableObject, setTextContent, setUserData

Methods inherited from class java.lang.Object

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

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, setNodeValue, 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

Method Detail

getWebRequest

public WebRequest getWebRequest(SubmittableElement submitElement)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Gets the request for a submission of this form with the specified SubmittableElement.

Parameters:

submitElement - the element that caused the submit to occur

Returns:

the request

getParameterListForSubmit

public List<NameValuePair> getParameterListForSubmit(SubmittableElement submitElement)

INTERNAL API - SUBJECT TO CHANGE AT ANY TIME - USE AT YOUR OWN RISK.
Returns a list of NameValuePairs that represent the data that will be sent to the server when this form is submitted. This is primarily intended to aid debugging.

Parameters:

submitElement - the element used to submit the form, or null if the form was submitted by JavaScript

Returns:

the list of NameValuePairs that represent that data that will be sent to the server when this form is submitted

reset

public Page reset()

Resets this form to its initial values, returning the page contained by this form's window after the reset. Note that the returned page may or may not be the same as the original page, based on JavaScript event handlers, etc.

Returns:

the page contained by this form's window after the reset

getInputsByName

public List<HtmlInput> getInputsByName(String name)

Returns all input elements which are members of this form and have the specified name.

Parameters:

name - the input name to search for

Returns:

all input elements which are members of this form and have the specified name

getInputByName

public final <I extends HtmlInput> I getInputByName(String name)
                                             throws ElementNotFoundException

Returns the first input element which is a member of this form and has the specified name.

Type Parameters:

I - the input type

Parameters:

name - the input name to search for

Returns:

the first input element which is a member of this form and has the specified name

Throws:

ElementNotFoundException - if there is not input in this form with the specified name

getSelectsByName

public List<HtmlSelect> getSelectsByName(String name)

Returns all the HtmlSelect elements in this form that have the specified name.

Parameters:

name - the name to search for

Returns:

all the HtmlSelect elements in this form that have the specified name

getSelectByName

public HtmlSelect getSelectByName(String name)
                           throws ElementNotFoundException

Returns the first HtmlSelect element in this form that has the specified name.

Parameters:

name - the name to search for

Returns:

the first HtmlSelect element in this form that has the specified name

Throws:

ElementNotFoundException - if this form does not contain a HtmlSelect element with the specified name

getButtonsByName

public List<HtmlButton> getButtonsByName(String name)

Returns all the HtmlButton elements in this form that have the specified name.

Parameters:

name - the name to search for

Returns:

all the HtmlButton elements in this form that have the specified name

getButtonByName

public HtmlButton getButtonByName(String name)
                           throws ElementNotFoundException

Returns the first HtmlButton element in this form that has the specified name.

Parameters:

name - the name to search for

Returns:

the first HtmlButton element in this form that has the specified name

Throws:

ElementNotFoundException - if this form does not contain a HtmlButton element with the specified name

getTextAreasByName

public List<HtmlTextArea> getTextAreasByName(String name)

Returns all the HtmlTextArea elements in this form that have the specified name.

Parameters:

name - the name to search for

Returns:

all the HtmlTextArea elements in this form that have the specified name

getTextAreaByName

public HtmlTextArea getTextAreaByName(String name)
                               throws ElementNotFoundException

Returns the first HtmlTextArea element in this form that has the specified name.

Parameters:

name - the name to search for

Returns:

the first HtmlTextArea element in this form that has the specified name

Throws:

ElementNotFoundException - if this form does not contain a HtmlTextArea element with the specified name

getRadioButtonsByName

public List<HtmlRadioButtonInput> getRadioButtonsByName(String name)

Returns all the HtmlRadioButtonInput elements in this form that have the specified name.

Parameters:

name - the name to search for

Returns:

all the HtmlRadioButtonInput elements in this form that have the specified name

getCheckedRadioButton

public HtmlRadioButtonInput getCheckedRadioButton(String name)

Returns the first checked radio button with the specified name. If none of the radio buttons by that name are checked, this method returns null.

Parameters:

name - the name of the radio button

Returns:

the first checked radio button with the specified name

getActionAttribute

public final String getActionAttribute()

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

Returns:

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

setActionAttribute

public final void setActionAttribute(String action)

Sets the value of the attribute action. Refer to the HTML 4.01 documentation for details on the use of this attribute.

Parameters:

action - the value of the attribute action

getMethodAttribute

public final String getMethodAttribute()

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

Returns:

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

setMethodAttribute

public final void setMethodAttribute(String method)

Sets the value of the attribute method. Refer to the HTML 4.01 documentation for details on the use of this attribute.

Parameters:

method - the value of the attribute method

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

setNameAttribute

public final void setNameAttribute(String name)

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

Parameters:

name - the value of the attribute name

getEnctypeAttribute

public final String getEnctypeAttribute()

Returns the value of the attribute enctype. Refer to the HTML 4.01 documentation for details on the use of this attribute. "Enctype" is the encoding type used when submitting a form back to the server.

Returns:

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

setEnctypeAttribute

public final void setEnctypeAttribute(String encoding)

Sets the value of the attribute enctype. Refer to the HTML 4.01 documentation for details on the use of this attribute. "Enctype" is the encoding type used when submitting a form back to the server.

Parameters:

encoding - the value of the attribute enctype

getOnSubmitAttribute

public final String getOnSubmitAttribute()

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

Returns:

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

getOnResetAttribute

public final String getOnResetAttribute()

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

Returns:

the value of the attribute onreset 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

getAcceptCharsetAttribute

public final String getAcceptCharsetAttribute()

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

Returns:

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

getTargetAttribute

public final String getTargetAttribute()

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

Returns:

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

setTargetAttribute

public final void setTargetAttribute(String target)

Sets the value of the attribute target. Refer to the HTML 4.01 documentation for details on the use of this attribute.

Parameters:

target - the value of the attribute target

getInputByValue

public <I extends HtmlInput> I getInputByValue(String value)
                                        throws ElementNotFoundException

Returns the first input in this form with the specified value.

Type Parameters:

I - the input type

Parameters:

value - the value to search for

Returns:

the first input in this form with the specified value

Throws:

ElementNotFoundException - if this form does not contain any inputs with the specified value

getInputsByValue

public List<HtmlInput> getInputsByValue(String value)

Returns all the inputs in this form with the specified value.

Parameters:

value - the value to search for

Returns:

all the inputs in this form with the specified value

getLostChildren

public List<HtmlElement> getLostChildren()

Gets the form elements that may be submitted but that don't belong to the form's children in the DOM due to incorrect HTML code.

Returns:

the elements

preventDefault

protected void preventDefault()

This method is called if the current fired event is canceled by preventDefault() in FireFox, or by returning false in Internet Explorer. The default implementation does nothing.

Overrides:

preventDefault in class DomElement

isEmptyXmlTagExpanded

protected boolean isEmptyXmlTagExpanded()

Browsers have problems with self closing form tags.

Overrides:

isEmptyXmlTagExpanded in class DomElement

Returns:

false by default