17.

1 Introduction to forms
An HTML form is a section of a document containing normal content, markup,
special elements called controls (checkboxes, radio buttons, menus, etc.), and
labels on those controls. Users generally "complete" a form by modifying its
controls (entering text, selecting menu items, etc.), before submitting the form
to an agent for processing (e.g., to a Web server, to a mail server, etc.)
Here's a simple form that includes labels, radio buttons, and push buttons
(reset the form or submit it):
<FORM action="http://somesite.com/prog/adduser" method="post">
<P>
<LABEL for="firstname">First name: </LABEL>
<INPUT type="text" id="firstname"><BR>
<LABEL for="lastname">Last name: </LABEL>
<INPUT type="text" id="lastname"><BR>
<LABEL for="email">email: </LABEL>
<INPUT type="text" id="email"><BR>
<INPUT type="radio" name="sex" value="Male"> Male<BR>
<INPUT type="radio" name="sex" value="Female"> Female<BR>
<INPUT type="submit" value="Send"> <INPUT type="reset">
</P>
</FORM>

Note. This specification includes more detailed information about forms in the
subsections on form display issues.

17.2 Controls
Users interact with forms through named controls.
A control's "control name" is given by its name attribute. The scope of
the name attribute for a control within a FORM element is the FORMelement.
Each control has both an initial value and a current value, both of which are
character strings. Please consult the definition of each control for information
about initial values and possible constraints on values imposed by the control.
In general, a control's "initial value" may be specified with the control
element's value attribute. However, the initial value of a TEXTAREA element
is given by its contents, and the initial value of an OBJECT element in a form is
determined by the object implementation (i.e., it lies outside the scope of this
specification).

The control's "current value" is first set to the initial value. Thereafter, the
control's current value may be modified through user interaction and scripts.
A control's initial value does not change. Thus, when a form is reset, each
control's current value is reset to its initial value. If a control does not have an
initial value, the effect of a form reset on that control is undefined.
When a form is submitted for processing, some controls have their name
paired with their current value and these pairs are submittedwith the form.
Those controls for which name/value pairs are submitted are called successful
controls.

17.2.1 Control types

HTML defines the following control types:
buttons
Authors may create three types of buttons:
submit buttons: When activated, a submit button submits a form. A
form may contain more than one submit button.
reset buttons: When activated, a reset button resets all controls to
their initial values.

push buttons: Push buttons have no default behavior. Each push

button may have client-side scripts associated with the
element's event attributes. When an event occurs (e.g., the user
presses the button, releases it, etc.), the associated script is
triggered.
Authors should specify the scripting language of a push button
script through a default script declaration (with the METAelement).

Authors create buttons with the BUTTON element or the INPUT element.
Please consult the definitions of these elements for details about
specifying different button types.
Note. Authors should note that the BUTTON element offers richer
rendering capabilities than the INPUT element.
checkboxes
Checkboxes (and radio buttons) are on/off switches that may be toggled
by the user. A switch is "on" when the control

element'schecked attribute is set. When a form is submitted, only "on"

checkbox controls can become successful.
Several checkboxes in a form may share the same control name. Thus,
for example, checkboxes allow users to select several values for the
same property. The INPUT element is used to create a checkbox
control.
radio buttons
Radio buttons are like checkboxes except that when several share the
same control name, they are mutually exclusive: when one is switched
"on", all others with the same name are switched "off".
The INPUT element is used to create a radio button control.
If no radio button in a set sharing the same control name is initially "on",
user agent behavior for choosing which control is initially "on" is
undefined. Note. Since existing implementations handle this case
differently, the current specification differs from RFC 1866
([RFC1866] section 8.1.2.4), which states:
At all times, exactly one of the radio buttons in a set is checked. If none
of the <INPUT> elements of a set of radio buttons specifies
`CHECKED', then the user agent must check the first radio button of the
set initially.
Since user agent behavior differs, authors should ensure that in each
set of radio buttons that one is initially "on".
menus
Menus offer users options from which to choose. The SELECT element
creates a menu, in combination with
the OPTGROUP andOPTION elements.
text input
Authors may create two types of controls that allow users to input text.
The INPUT element creates a single-line input control and
the TEXTAREA element creates a multi-line input control. In both cases,
the input text becomes the control's current value.
file select
This control type allows the user to select files so that their contents
may be submitted with a form. The INPUT element is used to create a
file select control.
hidden controls

Authors may create controls that are not rendered but whose values are
submitted with a form. Authors generally use this control type to store
information between client/server exchanges that would otherwise be
lost due to the stateless nature of HTTP (see[RFC2616]).
The INPUT element is used to create a hidden control.
object controls
Authors may insert generic objects in forms such that associated values
are submitted along with other controls. Authors create object controls
with the OBJECT element.
The elements used to create controls generally appear inside a FORM element,
but may also appear outside of a FORM element declaration when they are
used to build user interfaces. This is discussed in the section on intrinsic
events. Note that controls outside a form cannot be successful controls.

17.3 The FORM element

<!ELEMENT FORM - - (%block;|SCRIPT)+ -(FORM) -- interactive form -->
<!ATTLIST FORM
%attrs;
-- %coreattrs, %i18n, %events -action
%URI;
#REQUIRED -- server-side form handler -method
(GET|POST)
GET
-- HTTP method used to submit the
form-enctype
%ContentType; "application/x-www-form-urlencoded"
accept
%ContentTypes; #IMPLIED -- list of MIME types for file upload
-name
CDATA
#IMPLIED -- name of form for scripting -onsubmit
%Script;
#IMPLIED -- the form was submitted -onreset
%Script;
#IMPLIED -- the form was reset -accept-charset %Charsets; #IMPLIED -- list of supported charsets ->

Start tag: required, End tag: required

Attribute definitions
action = uri [CT]
This attribute specifies a form processing agent. User agent behavior for
a value other than an HTTP URI is undefined.
method = get|post [CI]
This attribute specifies which HTTP method will be used to submit
the form data set. Possible (case-insensitive) values are "get" (the
default) and "post". See the section on form submission for usage
information.
enctype = content-type [CI]

This attribute specifies the content type used to submit the form to the
server (when the value of method is "post"). The default value for this
attribute is "application/x-www-form-urlencoded". The
value "multipart/form-data" should be used in combination with
the INPUT element, type="file".
accept-charset = charset list [CI]
This attribute specifies the list of character encodings for input data that
is accepted by the server processing this form. The value is a spaceand/or comma-delimited list of charset values. The client must interpret
this list as an exclusive-or list, i.e., the server is able to accept any
single character encoding per entity received.
The default value for this attribute is the reserved string "UNKNOWN".
User agents may interpret this value as the character encoding that was
used to transmit the document containing this FORM element.
accept = content-type-list [CI]
This attribute specifies a comma-separated list of content types that a
server processing this form will handle correctly. User agents may use
this information to filter out non-conforming files when prompting a user
to select files to be sent to the server (cf. the INPUT element
when type="file").
name = cdata [CI]
This attribute names the element so that it may be referred to from style
sheets or scripts. Note. This attribute has been included for backwards
compatibility. Applications should use the id attribute to identify
elements.
Attributes defined elsewhere

id, class (document-wide identifiers)

lang (language information), dir (text direction)

style (inline style information)

title (element title)

target (target frame information)

onsubmit, onreset, onclick, ondblclick, onmousedown, onmou

seup, onmouseover, onmousemove, onmouseout, onkeypress,onk
eydown, onkeyup (intrinsic events)

The FORM element acts as a container for controls. It specifies:

The layout of the form (given by the contents of the element).

The program that will handle the completed and submitted form
(the action attribute). The receiving program must be able to parse
name/value pairs in order to make use of them.

The method by which user data will be sent to the server

(the method attribute).

A character encoding that must be accepted by the server in order to

handle this form (the accept-charset attribute). User agents may
advise the user of the value of the accept-charset attribute and/or
restrict the user's ability to enter unrecognized characters.

A form can contain text and markup (paragraphs, lists, etc.) in addition to form
controls.
The following example shows a form that is to be processed by the "adduser"
program when submitted. The form will be sent to the program using the
HTTP "post" method.
<FORM action="http://somesite.com/prog/adduser" method="post">
...form contents...
</FORM>

Please consult the section on form submission for information about how user
agents must prepare form data for servers and how user agents should
handle expected responses.
Note. Further discussion on the behavior of servers that receive form data is
beyond the scope of this specification.