W3C logo

org.w3c.dom.html2
Interface HTMLFormElement

All Superinterfaces:
Element, HTMLElement, Node

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_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE
 
Method Summary
 java.lang.String getAcceptCharset()
          List of character sets supported by the server.
 java.lang.String getAction()
          Server-side form handler.
 HTMLCollection getElements()
          Returns a collection of all form control elements in the form.
 java.lang.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.
 java.lang.String getMethod()
          HTTP method [IETF RFC 2616] used to submit form.
 java.lang.String getName()
          Names the form.
 java.lang.String getTarget()
          Frame to render the resource in.
 void reset()
          Restores a form element's default values.
 void setAcceptCharset(java.lang.String acceptCharset)
          List of character sets supported by the server.
 void setAction(java.lang.String action)
          Server-side form handler.
 void setEnctype(java.lang.String enctype)
          The content type of the submitted form, generally "application/x-www-form-urlencoded".
 void setMethod(java.lang.String method)
          HTTP method [IETF RFC 2616] used to submit form.
 void setName(java.lang.String name)
          Names the form.
 void setTarget(java.lang.String target)
          Frame to render the resource in.
 void submit()
          Submits the form.
 
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.Element
getAttribute, getAttributeNode, getAttributeNodeNS, getAttributeNS, getElementsByTagName, getElementsByTagNameNS, getTagName, hasAttribute, hasAttributeNS, removeAttribute, removeAttributeNode, removeAttributeNS, setAttribute, setAttributeNode, setAttributeNodeNS, setAttributeNS
 
Methods inherited from interface org.w3c.dom.Node
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix
 

Method Detail

getAcceptCharset

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

getAction

public java.lang.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 java.lang.String getEnctype()
The content type of the submitted form, generally "application/x-www-form-urlencoded". See the enctype attribute definition in HTML 4.01.

Note: 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 java.lang.String getMethod()
HTTP method [IETF RFC 2616] used to submit form. See the method attribute definition in HTML 4.01.

getName

public java.lang.String getName()
Names the form.

getTarget

public java.lang.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(java.lang.String acceptCharset)
List of character sets supported by the server. See the accept-charset attribute definition in HTML 4.01.

setAction

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

setEnctype

public void setEnctype(java.lang.String enctype)
The content type of the submitted form, generally "application/x-www-form-urlencoded". See the enctype attribute definition in HTML 4.01.

Note: 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(java.lang.String method)
HTTP method [IETF RFC 2616] used to submit form. See the method attribute definition in HTML 4.01.

setName

public void setName(java.lang.String name)
Names the form.

setTarget

public void setTarget(java.lang.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 © 2003 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.