W3C home > Mailing lists > Public > public-html-commits@w3.org > October 2008

html5/spec Overview.html,1.1492,1.1493

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Fri, 10 Oct 2008 02:55:00 +0000
To: public-html-commits@w3.org
Message-Id: <E1Ko89c-00072H-5D@lionel-hutz.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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 10 October 2008 02:55:09 GMT