- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 10 Oct 2008 02:55:00 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv27031
Modified Files:
Overview.html
Log Message:
WF2: Define the ailments for a form control. (whatwg r2320)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1492
retrieving revision 1.1493
diff -u -d -r1.1492 -r1.1493
--- Overview.html 10 Oct 2008 02:27:18 -0000 1.1492
+++ Overview.html 10 Oct 2008 02:54:57 -0000 1.1493
@@ -491,20 +491,20 @@
<li><a href=#enabling-and-disabling-form-controls><span class=secno>4.10.13.2 </span>Enabling and disabling form controls</a></li>
<li><a href=#a-form-control-s-value><span class=secno>4.10.13.3 </span>A form control's value</a></li>
<li><a href=#autofocusing-a-form-control><span class=secno>4.10.13.4 </span>Autofocusing a form control</a></li>
- <li><a href=#limiting-user-input-length><span class=secno>4.10.13.5 </span>Limiting user input length</a></ol></li>
- <li><a href=#attributes-for-form-submission><span class=secno>4.10.14 </span>Attributes for form submission</a></li>
- <li><a href=#constraints><span class=secno>4.10.15 </span>Constraints</a>
+ <li><a href=#limiting-user-input-length><span class=secno>4.10.13.5 </span>Limiting user input length</a></li>
+ <li><a href=#form-submission><span class=secno>4.10.13.6 </span>Form submission</a></ol></li>
+ <li><a href=#constraints><span class=secno>4.10.14 </span>Constraints</a>
<ol>
- <li><a href=#definitions><span class=secno>4.10.15.1 </span>Definitions</a></li>
- <li><a href=#constraint-validation><span class=secno>4.10.15.2 </span>Constraint validation</a></li>
- <li><a href=#the-constraint-validation-api><span class=secno>4.10.15.3 </span>The constraint validation API</a></ol></li>
- <li><a href=#form-submission><span class=secno>4.10.16 </span>Form submission</a>
+ <li><a href=#definitions><span class=secno>4.10.14.1 </span>Definitions</a></li>
+ <li><a href=#constraint-validation><span class=secno>4.10.14.2 </span>Constraint validation</a></li>
+ <li><a href=#the-constraint-validation-api><span class=secno>4.10.14.3 </span>The constraint validation API</a></ol></li>
+ <li><a href=#form-submission-0><span class=secno>4.10.15 </span>Form submission</a>
<ol>
- <li><a href=#url-encoded-form-data><span class=secno>4.10.16.1 </span>URL-encoded form data</a></li>
- <li><a href=#multipart-form-data><span class=secno>4.10.16.2 </span>Multipart form data</a></li>
- <li><a href=#plain-text-form-data><span class=secno>4.10.16.3 </span>Plain text form data</a></ol></li>
- <li><a href=#resetting-a-form><span class=secno>4.10.17 </span>Resetting a form</a></li>
- <li><a href=#event-dispatch><span class=secno>4.10.18 </span>Event dispatch</a></ol></li>
+ <li><a href=#url-encoded-form-data><span class=secno>4.10.15.1 </span>URL-encoded form data</a></li>
+ <li><a href=#multipart-form-data><span class=secno>4.10.15.2 </span>Multipart form data</a></li>
+ <li><a href=#plain-text-form-data><span class=secno>4.10.15.3 </span>Plain text form data</a></ol></li>
+ <li><a href=#resetting-a-form><span class=secno>4.10.16 </span>Resetting a form</a></li>
+ <li><a href=#event-dispatch><span class=secno>4.10.17 </span>Event dispatch</a></ol></li>
<li><a href=#interactive-elements><span class=secno>4.11 </span>Interactive elements</a>
<ol>
<li><a href=#the-details-element><span class=secno>4.11.1 </span>The <code>details</code> element</a></li>
@@ -18425,7 +18425,7 @@
name of an <a href=#ascii-compatible-character-encoding>ASCII-compatible character encoding</a>. <a href=#references>[IANACHARSET]</a><p>The <dfn id=attr-form-name title=attr-form-name><code>name</code></dfn> attribute
represents the <code><a href=#the-form-element>form</a></code>'s name within the <code title=dom-forms>forms</code> collection. The value must not be the
empty string, and the value must be unique amongst the
- <code><a href=#the-form-element>form</a></code> elements in the <code title=dom-forms>forms</code> collection that it is in, if any.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#attributes-for-form-submission>attributes
+ <code><a href=#the-form-element>form</a></code> elements in the <code title=dom-forms>forms</code> collection that it is in, if any.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
for form submission</a>.<p>The <dfn id=dom-form-accept-charset title=dom-form-accept-charset><code>accept-charset</code></dfn>
and <dfn id=dom-form-name title=dom-form-name><code>name</code></dfn> DOM
attributes must <a href=#reflect>reflect</a> the respective content
@@ -20645,8 +20645,8 @@
the user agent should allow the user to activate the element.<p>The element's <a href=#activation-behavior>activation behavior</a>, if the element
has a <a href=#form-owner>form owner</a>, is to <a href=#concept-form-submit title=concept-form-submit>submit</a> the <a href=#form-owner>form
owner</a> from the <code><a href=#the-input-element>input</a></code> element; otherwise, it is
- to do nothing.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes control the form
- submission.<div class=bookkeeping>
+ to do nothing.<p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
+ for form submission</a>.<div class=bookkeeping>
<p>The following common <code><a href=#the-input-element>input</a></code> element content
attributes and DOM attributes apply to the element:
@@ -20762,8 +20762,8 @@
and less than or equal to the rendered width, in CSS pixels, of the
image. The <var title="">y</var>-component must be greater than or
equal to zero, and less than or equal to the rendered height, in CSS
- pixels, of the image.</p><hr><p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes control the form
- submission.<div class=bookkeeping>
+ pixels, of the image.</p><hr><p>The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
+ for form submission</a>.<div class=bookkeeping>
<p>The following common <code><a href=#the-input-element>input</a></code> element content
attributes and DOM attributes apply to the element:
@@ -21320,8 +21320,8 @@
attribute represents the element's name. The <code title=attr-fe-disabled><a href=#attr-fe-disabled>disabled</a></code> attribute is used to make
the control non-interactive and to prevent its value from being
submitted. The <code title=attr-fe-autofocus><a href=#attr-fe-autofocus>autofocus</a></code>
- attribute controls focus. The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes control the form
- submission.<p>The <dfn id=attr-button-value title=attr-button-value><code>value</code></dfn>
+ attribute controls focus. The <code title=attr-fs-action><a href=#attr-fs-action>action</a></code>, <code title=attr-fs-enctype><a href=#attr-fs-enctype>enctype</a></code>, <code title=attr-fs-method><a href=#attr-fs-method>method</a></code>, and <code title=attr-fs-target><a href=#attr-fs-target>target</a></code> attributes are <a href=#form-submission>attributes
+ for form submission</a>.<p>The <dfn id=attr-button-value title=attr-button-value><code>value</code></dfn>
attribute gives the element's value for the purposes of form
submission. The <code title=attr-button-value><a href=#attr-button-value>value</a></code>
attribute must not be present unless the <code title=attr-fae-form><a href=#attr-fae-form>form</a></code> attribute is present. The
@@ -21984,7 +21984,7 @@
<a href=#maximum-allowed-value-length>maximum allowed value length</a>, then the element is
<a href=#suffering-from-being-too-long>suffering from being too long</a>.<p>User agents may prevent the user from causing the element's <a href=#concept-fe-value title=concept-fe-value>value</a> to be set to a value whose
<a href=#codepoint-length>codepoint length</a> is greater than the element's
- <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<h4 id=attributes-for-form-submission><span class=secno>4.10.14 </span><dfn>Attributes for form submission</dfn></h4><p>Attributes for form submission can be specified both on
+ <a href=#maximum-allowed-value-length>maximum allowed value length</a>.<h5 id=form-submission><span class=secno>4.10.13.6 </span><dfn title="attributes for form submission">Form submission</dfn></h5><p>Attributes for form submission can be specified both on
<code><a href=#the-form-element>form</a></code> elements and on elements that represent buttons
that submit forms, e.g. an <code><a href=#the-input-element>input</a></code> element whose <code title=attr-input-type><a href=#attr-input-type>type</a></code> attribute is in the <a href=#submit-button-state title=attr-input-type-submit>Submit Button</a> state. The
attributes on the buttons, when omitted, default to the values given
@@ -22036,17 +22036,54 @@
first such <code><a href=#the-base-element>base</a></code> element; or, if there is no such
element, the empty string.</p><!-- c.f. hyperlink following --><p>The <dfn id=dom-fs-action title=dom-fs-action><code>action</code></dfn>, <dfn id=dom-fs-method title=dom-fs-method><code>method</code></dfn>, <dfn id=dom-fs-enctype title=dom-fs-enctype><code>enctype</code></dfn>, and <dfn id=dom-fs-target title=dom-fs-target><code>target</code></dfn> DOM attributes must
<a href=#reflect>reflect</a> the respective content attributes of the same
- name.<h4 id=constraints><span class=secno>4.10.15 </span>Constraints</h4><h5 id=definitions><span class=secno>4.10.15.1 </span>Definitions</h5><p>A <a href=#category-listed title=category-listed>listed form-associated
+ name.<h4 id=constraints><span class=secno>4.10.14 </span>Constraints</h4><h5 id=definitions><span class=secno>4.10.14.1 </span>Definitions</h5><p>A <a href=#category-listed title=category-listed>listed form-associated
element</a> is a <dfn id=candidate-for-constraint-validation>candidate for constraint validation</dfn>
unless a condition has <dfn id=barred-from-constraint-validation title="barred from constraint
validation">barred the element from constraint
validation</dfn>. (For example, an element is <a href=#barred-from-constraint-validation>barred from
constraint validation</a> if it is an <code><a href=#the-output-element>output</a></code> or
- <code><a href=#the-fieldset-element>fieldset</a></code> element.)<p class=XXX>An element <dfn id=concept-fv-valid title=concept-fv-valid>satisfies its constraints</dfn> if ...<p class=XXX>... <dfn id=suffering-from-being-missing>suffering from being missing</dfn><p class=XXX>... <dfn id=suffering-from-a-type-mismatch>suffering from a type
- mismatch</dfn><p class=XXX>... <dfn id=suffering-from-a-pattern-mismatch>suffering from a pattern
- mismatch</dfn><p class=XXX>... <dfn id=suffering-from-being-too-long>suffering from being too
- long</dfn><p class=XXX>... <dfn id=suffering-from-an-underflow>suffering from an underflow</dfn><p class=XXX>... <dfn id=suffering-from-an-overflow>suffering from an overflow</dfn><p class=XXX>... <dfn id=suffering-from-a-step-mismatch>suffering from a step
- mismatch</dfn><h5 id=constraint-validation><span class=secno>4.10.15.2 </span>Constraint validation</h5><p>When the user agent is required to <dfn id=statically-validate-the-constraints>statically validate the
+ <code><a href=#the-fieldset-element>fieldset</a></code> element.)<p>An element can be constrained in various ways. The following is
+ the list of ailments that a form control can suffer from, making the
+ control invalid for the purposes of constraint valiation:<dl><dt> <dfn id=suffering-from-being-missing>Suffering from being missing</dfn> </dt>
+
+ <dd> <p>When a control has no <a href=#concept-fe-value title=concept-fe-value>value</a> but has a <code title="">required</code> attribute (<code><a href=#the-input-element>input</a></code> <code title=attr-input-required><a href=#attr-input-required>required</a></code>, <code><a href=#the-textarea-element>textarea</a></code>
+ <code title=attr-textarea-required><a href=#attr-textarea-required>required</a></code>). </dd>
+
+ <dt> <dfn id=suffering-from-a-type-mismatch>Suffering from a type mismatch</dfn> </dt>
+
+ <dd> <p>When a control that allows arbitrary user input has a <a href=#concept-fe-value title=concept-fe-value>value</a> that is not in the correct
+ syntax (<a href=#e-mail-state title=attr-input-type-email>E-mail</a>, <a href=#url-state title=attr-input-type-url>URL</a>). </dd>
+
+ <dt> <dfn id=suffering-from-a-pattern-mismatch>Suffering from a pattern mismatch</dfn> </dt>
+
+ <dd> <p>When a control has a <a href=#concept-fe-value title=concept-fe-value>value</a> that doesn't satisfy the
+ <code title=attr-input-pattern><a href=#attr-input-pattern>pattern</a></code> attribute.</dd>
+
+ <dt> <dfn id=suffering-from-being-too-long>Suffering from being too long</dfn> </dt>
+
+ <dd> <p>When a control has a <a href=#concept-fe-value title=concept-fe-value>value</a> that is too long for the
+ <a href=#attr-fe-maxlength title=attr-fe-maxlength>form control <code title="">maxlength</code> attribute</a> (<code><a href=#the-input-element>input</a></code>
+ <code title=attr-input-maxlength><a href=#attr-input-maxlength>maxlength</a></code>,
+ <code><a href=#the-textarea-element>textarea</a></code> <code title=attr-textarea-maxlength><a href=#attr-textarea-maxlength>maxlength</a></code>). </dd>
+
+ <dt> <dfn id=suffering-from-an-underflow>Suffering from an underflow</dfn> </dt>
+
+ <dd> <p>When a control has a <a href=#concept-fe-value title=concept-fe-value>value</a> that is too low for the <code title=attr-input-min><a href=#attr-input-min>min</a></code> attribute.</dd>
+
+ <dt> <dfn id=suffering-from-an-overflow>Suffering from an overflow</dfn> </dt>
+
+ <dd> <p>When a control has a <a href=#concept-fe-value title=concept-fe-value>value</a> that is too high for the
+ <code title=attr-input-max><a href=#attr-input-max>max</a></code> attribute.</dd>
+
+ <dt> <dfn id=suffering-from-a-step-mismatch>Suffering from a step mismatch</dfn> </dt>
+
+ <dd> <p>When a control has a <a href=#concept-fe-value title=concept-fe-value>value</a> that doesn't fit the rules
+ given by the <code title=attr-input-step><a href=#attr-input-step>step</a></code>
+ attribute.</dd>
+
+ </dl><p>An element <dfn id=concept-fv-valid title=concept-fv-valid>satisfies its
+ constraints</dfn> if it is not suffering from any of the above
+ ailments.<h5 id=constraint-validation><span class=secno>4.10.14.2 </span>Constraint validation</h5><p>When the user agent is required to <dfn id=statically-validate-the-constraints>statically validate the
constraints</dfn> of <code><a href=#the-form-element>form</a></code> element <var title="">form</var>, it must run the following steps, which return
either a <i>positive</i> result (all the controls in the form are
valid) or a <i>negative</i> result (there are invalid controls)
@@ -22120,13 +22157,13 @@
<li><p>Return a <i>negative</i> result.</li>
- </ol><h5 id=the-constraint-validation-api><span class=secno>4.10.15.3 </span>The <dfn>constraint validation API</dfn></h5><p>The <dfn id=dom-cva-willvalidate title=dom-cva-willValidate><code>willValidate</code></dfn>
+ </ol><h5 id=the-constraint-validation-api><span class=secno>4.10.14.3 </span>The <dfn>constraint validation API</dfn></h5><p>The <dfn id=dom-cva-willvalidate title=dom-cva-willValidate><code>willValidate</code></dfn>
attribute must return true if an element is a <a href=#candidate-for-constraint-validation>candidate for
constraint validation</a>, and false otherwise (i.e. false if any
conditions are <a href=#barred-from-constraint-validation title="barred from constraint
validation">barring it from constraint validation</a>).<p class=XXX> <dfn id=dom-cva-validity title=dom-cva-validity><code>validity</code></dfn> <dfn id=dom-cva-validationmessage title=dom-cva-validationMessage><code>validationMessage</code></dfn>
<dfn id=dom-cva-checkvalidatity title=dom-cva-checkValidatity><code>checkValidity()</code></dfn>
- <dfn id=dom-cva-setcustomvalidity title=dom-cva-setCustomValidity><code>setCustomValidity()</code></dfn><h4 id=form-submission><span class=secno>4.10.16 </span>Form submission</h4><!-- XXX http://lxr.mozilla.org/mozilla/source/content/html/content/src/nsHTMLFormElement.cpp --><p>When a form <var title="">form</var> is <dfn id=concept-form-submit title=concept-form-submit>submitted</dfn> from an element <var title="">submitter</var> (typically a button), the user agent must
+ <dfn id=dom-cva-setcustomvalidity title=dom-cva-setCustomValidity><code>setCustomValidity()</code></dfn><h4 id=form-submission-0><span class=secno>4.10.15 </span>Form submission</h4><!-- XXX http://lxr.mozilla.org/mozilla/source/content/html/content/src/nsHTMLFormElement.cpp --><p>When a form <var title="">form</var> is <dfn id=concept-form-submit title=concept-form-submit>submitted</dfn> from an element <var title="">submitter</var> (typically a button), the user agent must
run the following steps:<ol><li id=sandboxSubmitBlocked><p>If <var title="">form</var> is in
a <code>Document</code> that has no associated <a href=#browsing-context>browsing
context</a> or whose <a href=#browsing-context>browsing context</a> has its
@@ -22587,34 +22624,34 @@
</dl></li>
- </ol><h5 id=url-encoded-form-data><span class=secno>4.10.16.1 </span>URL-encoded form data</h5><p>The <dfn id=application-x-www-form-urlencoded-encoding-algorithm><code title="">application/x-www-form-urlencoded</code> encoding
+ </ol><h5 id=url-encoded-form-data><span class=secno>4.10.15.1 </span>URL-encoded form data</h5><p>The <dfn id=application-x-www-form-urlencoded-encoding-algorithm><code title="">application/x-www-form-urlencoded</code> encoding
algorithm</dfn> is as follows:<ol><li><p class=XXX>...</li>
<!-- During this step, the form data set is examined to ensure all
the characters are representable in the submission character
encoding. -->
- </ol><h5 id=multipart-form-data><span class=secno>4.10.16.2 </span>Multipart form data</h5><p>The <dfn id=multipart-form-data-encoding-algorithm><code title="">multipart/form-data</code> encoding
+ </ol><h5 id=multipart-form-data><span class=secno>4.10.15.2 </span>Multipart form data</h5><p>The <dfn id=multipart-form-data-encoding-algorithm><code title="">multipart/form-data</code> encoding
algorithm</dfn> is as follows:<ol><li><p class=XXX>...</li>
<!-- During this step, the form data set is examined to ensure all
the characters are representable in the submission character
encoding. -->
- </ol><h5 id=plain-text-form-data><span class=secno>4.10.16.3 </span>Plain text form data</h5><p>The <dfn id=text-plain-encoding-algorithm><code title="">text/plain</code> encoding
+ </ol><h5 id=plain-text-form-data><span class=secno>4.10.15.3 </span>Plain text form data</h5><p>The <dfn id=text-plain-encoding-algorithm><code title="">text/plain</code> encoding
algorithm</dfn> is as follows:<ol><li><p class=XXX>...</li>
<!-- During this step, the form data set is examined to ensure all
the characters are representable in the submission character
encoding. -->
- </ol><h4 id=resetting-a-form><span class=secno>4.10.17 </span>Resetting a form</h4><p>When a form <var title="">form</var> is <dfn id=concept-form-reset title=concept-form-reset>reset</dfn>, the user agent must invoke
+ </ol><h4 id=resetting-a-form><span class=secno>4.10.16 </span>Resetting a form</h4><p>When a form <var title="">form</var> is <dfn id=concept-form-reset title=concept-form-reset>reset</dfn>, the user agent must invoke
the <a href=#concept-form-reset-control title=concept-form-reset-control>reset algorithm</a>
of each <a href=#category-reset title=category-reset>resettable</a> elements
whose <a href=#form-owner>form owner</a> is <var title="">form</var>, and must
then <a href=#broadcast-formchange-events>broadcast <code title=event-formchange>formchange</code> events</a> from <var title="">form</var>.<p>Each <a href=#category-reset title=category-reset>resettable</a> element
defines its own <dfn id=concept-form-reset-control title=concept-form-reset-control>reset
- algorithm</dfn>.<h4 id=event-dispatch><span class=secno>4.10.18 </span>Event dispatch</h4><p>When the user agent is to <dfn id=broadcast-forminput-events>broadcast <code title=event-forminput>forminput</code> events</dfn> or
+ algorithm</dfn>.<h4 id=event-dispatch><span class=secno>4.10.17 </span>Event dispatch</h4><p>When the user agent is to <dfn id=broadcast-forminput-events>broadcast <code title=event-forminput>forminput</code> events</dfn> or
<dfn id=broadcast-formchange-events>broadcast <code title=event-formchange>formchange</code>
events</dfn> from a <code><a href=#the-form-element>form</a></code> element <var title="">form</var>, it must run the following steps:<ol><li><p>Let <var title="">controls</var> be a list of all the <a href=#category-reset title=category-reset>resettable</a> elements whose <a href=#form-owner>form
owner</a> is <var title="">form</var>.</li>
Received on Friday, 10 October 2008 02:55:09 UTC