form
elementform
element descendants.accept-charset
action
autocomplete
enctype
method
name
novalidate
target
[OverrideBuiltins] interface HTMLFormElement : HTMLElement { attribute DOMString acceptCharset; attribute DOMString action; attribute DOMString autocomplete; attribute DOMString enctype; attribute DOMString encoding; attribute DOMString method; attribute DOMString name; attribute boolean noValidate; attribute DOMString target; readonly attribute HTMLFormControlsCollection elements; readonly attribute long length; caller getter any (in unsigned long index); caller getter any (in DOMString name); void submit(); void reset(); boolean checkValidity(); };
The form
element represents a collection of form-associated elements, some of which can represent editable values that can be submitted to a server for processing.
The accept-charset
attribute gives the character encodings that are to be used for the submission. If specified, the value must be an ordered set of unique space-separated tokens that are ASCII case-insensitive, and each token must be an ASCII case-insensitive match for the preferred MIME name of an ASCII-compatible character encoding. [IANACHARSET]
The name
attribute represents the form
's name within the forms
collection. The value must not be the empty string, and the value must be unique amongst the form
elements in the forms
collection that it is in, if any.
The autocomplete
attribute is an enumerated attribute. The attribute has two states. The on
keyword maps to the on state, and the off
keyword maps to the off state. The attribute may also be omitted. The missing value default is the on state. The off state
indicates that by default, input
elements in the form will have their resulting autocompletion state set to off; the on state indicates that by default, input
elements in the form will have their resulting
autocompletion state set to on.
The action
, enctype
, method
, novalidate
, and target
attributes are attributes for form submission.
elements
Returns an HTMLCollection
of the form controls in the form (excluding image buttons for historical reasons).
length
Returns the number of form controls in the form (excluding image buttons for historical reasons).
Returns the indexth element in the form (excluding image buttons for historical reasons).
Returns the form control in the form with the given ID or name
(excluding image buttons for historical reasons).
Once an element has been referenced using a particular name, that name will continue being available as a way to reference that element in this method, even if the element's actual ID or name
changes, for as long as the element remains in the Document
.
If there are multiple matching items, then a NodeList
object containing all those elements is returned.
Returns null if no element with that ID or name
could be found.
submit
()Submits the form.
reset
()Resets the form.
checkValidity
()Returns true if the form's controls are all valid; otherwise, returns false.
The autocomplete
IDL attribute must reflect the content attribute of the same name, limited to only known values.
The name
IDL attribute must reflect the content attribute of the same name.
The acceptCharset
IDL attribute must reflect the accept-charset
content attribute.
This example shows two search forms:
<form action="http://www.google.com/search" method="get"> <label>Google: <input type="search" name="q"></label> <input type="submit" value="Search..."> </form> <form action="http://www.bing.com/search" method="get"> <label>Bing: <input type="search" name="q"></label> <input type="submit" value="Search..."> </form>