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; getter Element (unsigned long index); getter object (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 (or, if there are several, a
RadioNodeList
of the form controls) in
the form with the given ID or name
(excluding image buttons for historical
reasons); or, if there are none, returns the img
element with the given ID.
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 RadioNodeList
object containing all
those elements is returned.
submit
()Submits the form.
reset
()Resets the form.
checkValidity
()Returns true if the form's controls are all valid; otherwise, returns false.
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>