HTML Standard Tracker

Filter

File a bug

SVNBugCommentTime (UTC)
2320WF2: Define the ailments for a form control.2008-10-10 02:54
@@ -28312,22 +28312,22 @@ function AddCloud(data, x, y) { ... }</pre>
 
   <p>The element's <span>activation behavior</span>, if the element
   has a <span>form owner</span>, is to <span
   title="concept-form-submit">submit</span> the <span>form
   owner</span> from the <code>input</code> element; otherwise, it is
   to do nothing.</p>
 
   <p>The <code title="attr-fs-action">action</code>, <code
   title="attr-fs-enctype">enctype</code>, <code
   title="attr-fs-method">method</code>, and <code
-  title="attr-fs-target">target</code> attributes control the form
-  submission.</p>
+  title="attr-fs-target">target</code> attributes are <span>attributes
+  for form submission</span>.</p>
 
   <div class="bookkeeping">
 
    <p>The following common <code>input</code> element content
    attributes and DOM attributes apply to the element:
    <code title="attr-fs-action">action</code>,
    <code title="attr-fs-enctype">enctype</code>,
    <code title="attr-fs-method">method</code>, and
    <code title="attr-fs-target">target</code> content attributes;
    <code title="dom-input-value">value</code> DOM attribute.</p>
@@ -28509,22 +28509,22 @@ function AddCloud(data, x, y) { ... }</pre>
   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">action</code>, <code
   title="attr-fs-enctype">enctype</code>, <code
   title="attr-fs-method">method</code>, and <code
-  title="attr-fs-target">target</code> attributes control the form
-  submission.</p>
+  title="attr-fs-target">target</code> attributes are <span>attributes
+  for form submission</span>.</p>
 
   <div class="bookkeeping">
 
    <p>The following common <code>input</code> element content
    attributes and DOM attributes apply to the element:
    <code title="attr-fs-action">action</code>,
    <code title="attr-input-alt">alt</code>,
    <code title="attr-fs-enctype">enctype</code>,
    <code title="attr-fs-method">method</code>, 
    <code title="attr-input-src">src</code>, and
@@ -29484,22 +29484,22 @@ function AddCloud(data, x, y) { ... }</pre>
   explicitly associate the <code>button</code> element with its
   <span>form owner</span>. The <code title="attr-fe-name">name</code>
   attribute represents the element's name. The <code
   title="attr-fe-disabled">disabled</code> attribute is used to make
   the control non-interactive and to prevent its value from being
   submitted. The <code title="attr-fe-autofocus">autofocus</code>
   attribute controls focus. The <code
   title="attr-fs-action">action</code>, <code
   title="attr-fs-enctype">enctype</code>, <code
   title="attr-fs-method">method</code>, and <code
-  title="attr-fs-target">target</code> attributes control the form
-  submission.</p>
+  title="attr-fs-target">target</code> attributes are <span>attributes
+  for form submission</span>.</p>
 
   <p>The <dfn 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">value</code>
   attribute must not be present unless the <code
   title="attr-fae-form">form</code> attribute is present. The
   element's <span title="concept-fe-value">value</span> is the value
   of the element's <code title="attr-button-value">value</code>
   attribute, if there is one, or the empty string otherwise.</p>
 
@@ -30652,21 +30652,21 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
   <span>maximum allowed value length</span>, then the element is
   <span>suffering from being too long</span>.</p>
 
   <p>User agents may prevent the user from causing the element's <span
   title="concept-fe-value">value</span> to be set to a value whose
   <span>codepoint length</span> is greater than the element's
   <span>maximum allowed value length</span>.</p>
 
 
 
-  <h4><dfn>Attributes for form submission</dfn></h4>
+  <h5><dfn title="attributes for form submission">Form submission</dfn></h5>
 
   <p>Attributes for form submission can be specified both on
   <code>form</code> elements and on elements that represent buttons
   that submit forms, e.g. an <code>input</code> element whose <code
   title="attr-input-type">type</code> attribute is in the <span
   title="attr-input-type-submit">Submit Button</span> state. The
   attributes on the buttons, when omitted, default to the values given
   on the corresponding the <code>form</code> element.</p>
 
   <p>The <dfn title="attr-fs-action"><code>action</code></dfn> content
@@ -30769,40 +30769,81 @@ interface <dfn>HTMLOptionElement</dfn> : <span>HTMLElement</span> {
   <h5>Definitions</h5>
 
   <p>A <span title="category-listed">listed form-associated
   element</span> is a <dfn>candidate for constraint validation</dfn>
   unless a condition has <dfn title="barred from constraint
   validation">barred the element from constraint
   validation</dfn>. (For example, an element is <span>barred from
   constraint validation</span> if it is an <code>output</code> or
   <code>fieldset</code> element.)</p>
 
-  <p class="XXX">An element <dfn
-  title="concept-fv-valid">satisfies its constraints</dfn> if ...</p>
+  <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:</p>
+
+  <dl>
+
+   <dt> <dfn>Suffering from being missing</dfn> </dt>
+
+   <dd> <p>When a control has no <span
+   title="concept-fe-value">value</span> but has a <code
+   title="">required</code> attribute (<code>input</code> <code
+   title="attr-input-required">required</code>, <code>textarea</code>
+   <code title="attr-textarea-required">required</code>). </p></dd>
 
-  <p class="XXX">... <dfn>suffering from being missing</dfn></p>
+   <dt> <dfn>Suffering from a type mismatch</dfn> </dt>
 
-  <p class="XXX">... <dfn>suffering from a type
-  mismatch</dfn></p>
+   <dd> <p>When a control that allows arbitrary user input has a <span
+   title="concept-fe-value">value</span> that is not in the correct
+   syntax (<span title="attr-input-type-email">E-mail</span>, <span
+   title="attr-input-type-url">URL</span>). </p></dd>
 
-  <p class="XXX">... <dfn>suffering from a pattern
-  mismatch</dfn></p>
+   <dt> <dfn>Suffering from a pattern mismatch</dfn> </dt>
 
-  <p class="XXX">... <dfn>suffering from being too
-  long</dfn></p>
+   <dd> <p>When a control has a <span
+   title="concept-fe-value">value</span> that doesn't satisfy the
+   <code title="attr-input-pattern">pattern</code> attribute.</p></dd>
 
-  <p class="XXX">... <dfn>suffering from an underflow</dfn></p>
+   <dt> <dfn>Suffering from being too long</dfn> </dt>
 
-  <p class="XXX">... <dfn>suffering from an overflow</dfn></p>
+   <dd> <p>When a control has a <span
+   title="concept-fe-value">value</span> that is too long for the
+   <span title="attr-fe-maxlength">form control <code
+   title="">maxlength</code> attribute</span> (<code>input</code>
+   <code title="attr-input-maxlength">maxlength</code>,
+   <code>textarea</code> <code
+   title="attr-textarea-maxlength">maxlength</code>). </p></dd>
+
+   <dt> <dfn>Suffering from an underflow</dfn> </dt>
+
+   <dd> <p>When a control has a <span
+   title="concept-fe-value">value</span> that is too low for the <code
+   title="attr-input-min">min</code> attribute.</p></dd>
+
+   <dt> <dfn>Suffering from an overflow</dfn> </dt>
+
+   <dd> <p>When a control has a <span
+   title="concept-fe-value">value</span> that is too high for the
+   <code title="attr-input-max">max</code> attribute.</p></dd>
+
+   <dt> <dfn>Suffering from a step mismatch</dfn> </dt>
+
+   <dd> <p>When a control has a <span
+   title="concept-fe-value">value</span> that doesn't fit the rules
+   given by the <code title="attr-input-step">step</code>
+   attribute.</p></dd>
+
+  </dl>
 
-  <p class="XXX">... <dfn>suffering from a step
-  mismatch</dfn></p>
+  <p>An element <dfn title="concept-fv-valid">satisfies its
+  constraints</dfn> if it is not suffering from any of the above
+  ailments.</p>
 
 
 
   <h5>Constraint validation</h5>
 
   <p>When the user agent is required to <dfn>statically validate the
   constraints</dfn> of <code>form</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)

|