org.w3c.dom.html2

Interface HTMLFormElement

All Superinterfaces:
Element, HTMLElement, Node
Known Implementing Classes:
DomHTMLFormElement

public interface HTMLFormElement
extends HTMLElement

The FORM element encompasses behavior similar to a collection and an element. It provides direct access to the contained form controls as well as the attributes of the form element. See the FORM element definition in HTML 4.01.

See also the Document Object Model (DOM) Level 2 HTML Specification.

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

String
getAcceptCharset()
List of character sets supported by the server.
String
getAction()
Server-side form handler.
HTMLCollection
getElements()
Returns a collection of all form control elements in the form.
String
getEnctype()
The content type of the submitted form, generally "application/x-www-form-urlencoded".
int
getLength()
The number of form controls in the form.
String
getMethod()
HTTP method [IETF RFC 2616] used to submit form.
String
getName()
Names the form.
String
getTarget()
Frame to render the resource in.
void
reset()
Restores a form element's default values.
void
setAcceptCharset(String acceptCharset)
List of character sets supported by the server.
void
setAction(String action)
Server-side form handler.
void
setEnctype(String enctype)
The content type of the submitted form, generally "application/x-www-form-urlencoded".
void
setMethod(String method)
HTTP method [IETF RFC 2616] used to submit form.
void
setName(String name)
Names the form.
void
setTarget(String target)
Frame to render the resource in.
void
submit()
Submits the form.

Methods inherited from interface org.w3c.dom.Element

getAttribute, getAttributeNS, getAttributeNode, getAttributeNodeNS, getElementsByTagName, getElementsByTagNameNS, getSchemaTypeInfo, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNS, removeAttributeNode, setAttribute, setAttributeNS, setAttributeNode, setAttributeNodeNS, setIdAttribute, setIdAttributeNS, setIdAttributeNode

Methods inherited from interface org.w3c.dom.html2.HTMLElement

getClassName, getDir, getId, getLang, getTitle, setClassName, setDir, setId, setLang, setTitle

Methods inherited from interface org.w3c.dom.Node

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

Method Details

getAcceptCharset

public String getAcceptCharset()
List of character sets supported by the server. See the accept-charset attribute definition in HTML 4.01.

getAction

public String getAction()
Server-side form handler. See the action attribute definition in HTML 4.01.

getElements

public HTMLCollection getElements()
Returns a collection of all form control elements in the form.

getEnctype

public String getEnctype()
The content type of the submitted form, generally "application/x-www-form-urlencoded". See the enctype attribute definition in HTML 4.01. The onsubmit even handler is not guaranteed to be triggered when invoking this method. The behavior is inconsistent for historical reasons and authors should not rely on a particular one.

getLength

public int getLength()
The number of form controls in the form.

getMethod

public String getMethod()
HTTP method [IETF RFC 2616] used to submit form. See the method attribute definition in HTML 4.01.

getName

public String getName()
Names the form.

getTarget

public String getTarget()
Frame to render the resource in. See the target attribute definition in HTML 4.01.

reset

public void reset()
Restores a form element's default values. It performs the same action as a reset button.

setAcceptCharset

public void setAcceptCharset(String acceptCharset)
List of character sets supported by the server. See the accept-charset attribute definition in HTML 4.01.

setAction

public void setAction(String action)
Server-side form handler. See the action attribute definition in HTML 4.01.

setEnctype

public void setEnctype(String enctype)
The content type of the submitted form, generally "application/x-www-form-urlencoded". See the enctype attribute definition in HTML 4.01. The onsubmit even handler is not guaranteed to be triggered when invoking this method. The behavior is inconsistent for historical reasons and authors should not rely on a particular one.

setMethod

public void setMethod(String method)
HTTP method [IETF RFC 2616] used to submit form. See the method attribute definition in HTML 4.01.

setName

public void setName(String name)
Names the form.

setTarget

public void setTarget(String target)
Frame to render the resource in. See the target attribute definition in HTML 4.01.

submit

public void submit()
Submits the form. It performs the same action as a submit button.

* Copyright (c) 2003 World Wide Web Consortium, * (Massachusetts Institute of Technology, Institut National de * Recherche en Informatique et en Automatique, Keio University). All * Rights Reserved. This program is distributed under the W3C's Software * Intellectual Property License. This program is distributed in the * hope that it will be useful, but WITHOUT ANY WARRANTY; without even * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR * PURPOSE. * See W3C License http://www.w3.org/Consortium/Legal/ for more details.