[html5] r2175 - [] (0) WF2: form.reset() and a rework of how we categorise form control elements.

whatwg at whatwg.org whatwg at whatwg.org
Fri Sep 12 18:03:43 PDT 2008


Author: ianh
Date: 2008-09-12 18:03:43 -0700 (Fri, 12 Sep 2008)
New Revision: 2175

Modified:
   index
   source
Log:
[] (0) WF2: form.reset() and a rework of how we categorise form control elements.

Modified: index
===================================================================
--- index	2008-09-13 00:36:32 UTC (rev 2174)
+++ index	2008-09-13 01:03:43 UTC (rev 2175)
@@ -1084,6 +1084,12 @@
          <li><a href="#plain"><span class=secno>4.9.16.3. </span>Plain text
           form data</a>
         </ul>
+
+       <li><a href="#resetting"><span class=secno>4.9.17 </span>Resetting a
+        form</a>
+
+       <li><a href="#event"><span class=secno>4.9.18 </span>Event
+        dispatch</a>
       </ul>
 
      <li><a href="#scripting1"><span class=secno>4.10 </span>Scripting</a>
@@ -1303,7 +1309,7 @@
        <li><a href="#script0"><span class=secno>5.4.1 </span>Script execution
         contexts</a>
 
-       <li><a href="#event"><span class=secno>5.4.2 </span>Event loops</a>
+       <li><a href="#event0"><span class=secno>5.4.2 </span>Event loops</a>
 
        <li><a href="#security4"><span class=secno>5.4.3 </span>Security
         exceptions</a>
@@ -1316,7 +1322,7 @@
          <li><a href="#event-handler-attributes"><span class=secno>5.4.5.1.
           </span>Event handler attributes</a>
 
-         <li><a href="#event0"><span class=secno>5.4.5.2. </span>Event
+         <li><a href="#event1"><span class=secno>5.4.5.2. </span>Event
           firing</a>
 
          <li><a href="#events0"><span class=secno>5.4.5.3. </span>Events and
@@ -1478,7 +1484,7 @@
          <li><a href="#the-storage0"><span class=secno>5.10.1.5. </span>The
           <code title=event-storage>storage</code> event</a>
           <ul class=toc>
-           <li><a href="#event1"><span class=secno>5.10.1.5.1. </span>Event
+           <li><a href="#event2"><span class=secno>5.10.1.5.1. </span>Event
             definition</a>
           </ul>
 
@@ -1747,7 +1753,7 @@
 
    <li><a href="#comms"><span class=secno>7. </span>Communication</a>
     <ul class=toc>
-     <li><a href="#event2"><span class=secno>7.1 </span>Event definitions</a>
+     <li><a href="#event3"><span class=secno>7.1 </span>Event definitions</a>
       
 
      <li><a href="#server-sent-events"><span class=secno>7.2
@@ -6739,8 +6745,10 @@
   <p>The <code><a
    href="#htmlformcontrolscollection0">HTMLFormControlsCollection</a></code>
    interface represents a <a href="#collections0"
-   title=collections>collection</a> of <a href="#field"
-   title=category-field>field elements</a>.
+   title=collections>collection</a> of <a href="#listed"
+   title=category-listed>listed</a> elements in <code><a
+   href="#form">form</a></code> and <code><a
+   href="#fieldset">fieldset</a></code> elements.
 
   <pre
    class=idl>interface <dfn id=htmlformcontrolscollection0>HTMLFormControlsCollection</dfn> {
@@ -7788,7 +7796,7 @@
            attribute DOMString <a href="#registrationmark0" title=dom-registrationMark>registrationMark</a>;
   readonly attribute DocumentFragment <a href="#originalcontent" title=dom-originalContent>originalContent</a>;
 
-  // <a href="#event6">event handler DOM attributes</a>
+  // <a href="#event7">event handler DOM attributes</a>
            attribute <span>EventListener</span> <a href="#onabort" title=handler-onabort>onabort</a>;
            attribute <span>EventListener</span> <a href="#onbeforeunload" title=handler-onbeforeunload>onbeforeunload</a>;
            attribute <span>EventListener</span> <a href="#onblur" title=handler-onblur>onblur</a>;
@@ -7872,7 +7880,7 @@
    <dd><code title=attr-title><a href="#title">title</a></code>
   </dl>
 
-  <p>In addition, the following <a href="#event5">event handler content
+  <p>In addition, the following <a href="#event6">event handler content
    attributes</a> may be specified on any <span>HTML element</span>:
 
   <dl class=element>
@@ -26540,21 +26548,37 @@
    content attribute with a matching <code title=dom-fae-form><a
    href="#form1">form</a></code> DOM attribute.
 
-  <p>The controls that can end up being submitted back to the server are <dfn
-   id=field title=category-field>field elements</dfn>.
+  <p>The <a href="#form-associated" title="form-associated
+   element">form-associated elements</a> fall into several subcategories:
 
-  <p>The controls that are exposed to the <code title=dom-form-elements><a
-   href="#elements3"><var title="">form</var>.elements</a></code> and <code
-   title=dom-fieldset-elements><a href="#elements4"><var
-   title="">fieldset</var>.elements</a></code> APIs are <dfn id=listed
-   title=category-listed-form-element>listed form elements</dfn>. This is a
-   superset of the <a href="#field" title=category-field>field elements</a>.
+  <dl>
+   <dt><dfn id=submittable title=category-submit>Submittable elements</dfn>
 
-  <p>Some <a href="#field" title=category-field>field elements</a> can be,
-   depending on their attributes, <dfn id=buttons
-   title=concept-button>buttons</dfn>. The prose below defines when an
-   element is a button.
+   <dd>Denotes elements that can be used for <a
+    href="#constructing-form-data-set">constructing the form data set</a>
+    when a <code><a href="#form">form</a></code> element is <a
+    href="#submitted" title=concept-form-submit>submit</a>.
 
+   <dt><dfn id=resettable title=category-reset>Resettable elements</dfn>
+
+   <dd>Denotes elements that can be affected when a <code><a
+    href="#form">form</a></code> element is <a href="#reset1"
+    title=concept-form-reset>reset</a>.
+
+   <dt><dfn id=listed title=category-listed>Listed</dfn>
+
+   <dd>Denotes elements that are listed in the <code
+    title=dom-form-elements><a href="#elements3"><var
+    title="">form</var>.elements</a></code> and <code
+    title=dom-fieldset-elements><a href="#elements4"><var
+    title="">fieldset</var>.elements</a></code> APIs.
+  </dl>
+
+  <p>In addition, some <a href="#submittable"
+   title=category-submit>submittable</a> can be, depending on their
+   attributes, <dfn id=buttons title=concept-button>buttons</dfn>. The prose
+   below defines when an element is a button.
+
   <h4 id=the-form><span class=secno>4.9.1 </span>The <dfn
    id=form><code>form</code></dfn> element</h4>
 
@@ -26605,7 +26629,7 @@
   [NameGetter] Object <a href="#xxx8" title=dom-form-XXX8>XXX8</a>(in DOMString name);
 
   void <a href="#submit" title=dom-form-submit>submit</a>();
-  void <span title=dom-form-reset>reset</span>();
+  void <a href="#reset" title=dom-form-reset>reset</a>();
   boolean <span title=dom-form-checkValidity>checkValidity</span>();
 
   void <span title=dom-form-dispatchFormInput>dispatchFormInput</span>();
@@ -26614,8 +26638,9 @@
   </dl>
 
   <p>The <code><a href="#form">form</a></code> element represents a
-   collection of <a href="#field" title=category-field>data fields</a> that
-   can be submitted to a server for processing.
+   collection of <a href="#form-associated" title="form-associated
+   element">form-associated elements</a>, some of which can represent
+   editable values that can be submitted to a server for processing.
 
   <p>The <dfn id=accept-charset
    title=attr-form-accept-charset><code>accept-charset</code></dfn> attribute
@@ -26648,8 +26673,8 @@
    return an <code><a
    href="#htmlformcontrolscollection0">HTMLFormControlsCollection</a></code>
    rooted at the <code>Document</code> node, whose filter matches <a
-   href="#listed" title=category-listed-form-element>listed form elements</a>
-   whose <a href="#form-owner">form owner</a> is the <code><a
+   href="#listed" title=category-listed>listed</a> elements whose <a
+   href="#form-owner">form owner</a> is the <code><a
    href="#form">form</a></code> element, with the exception of <code><a
    href="#input0">input</a></code> elements whose <code
    title=attr-input-type>type</code> attribute is in the <span
@@ -26685,6 +26710,11 @@
    href="#form">form</a></code> element from the <code><a
    href="#form">form</a></code> element itself.
 
+  <p>The <dfn id=reset title=dom-form-reset><code>reset()</code></dfn>
+   method, when invoked, must <a href="#reset1"
+   title=concept-form-reset>reset</a> the <code><a
+   href="#form">form</a></code> element.
+
   <p class=big-issue>...
 
   <h4 id=the-fieldset><span class=secno>4.9.2 </span>The <dfn
@@ -26695,11 +26725,9 @@
 
    <dd><a href="#flow-content0">Flow content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#flow-content0">flow content</a> is expected.
@@ -26744,9 +26772,8 @@
    return an <code><a
    href="#htmlformcontrolscollection0">HTMLFormControlsCollection</a></code>
    rooted at the <code>Document</code> node, whose filter matches <a
-   href="#listed" title=category-listed-form-element>listed form elements</a>
-   that are descendants of the <code><a href="#fieldset">fieldset</a></code>
-   element.
+   href="#listed" title=category-listed>listed</a> elements that are
+   descendants of the <code><a href="#fieldset">fieldset</a></code> element.
 
   <h4 id=the-input><span class=secno>4.9.3 </span>The <dfn
    id=input0><code>input</code></dfn> element</h4>
@@ -26758,13 +26785,11 @@
 
    <dd><a href="#interactive1">Interactive content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a>, <a
+    href="#submittable" title=category-submit>submittable</a>, and <a
+    href="#resettable" title=category-reset>resettable</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#field" title=category-field>Field element</a>.
-
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
@@ -26899,13 +26924,10 @@
 
    <dd><a href="#interactive1">Interactive content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a> and <a
+    href="#submittable" title=category-submit>submittable</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#field" title=category-field>Field element</a>.
-
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
@@ -27013,13 +27035,11 @@
 
    <dd><a href="#interactive1">Interactive content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a>, <a
+    href="#submittable" title=category-submit>submittable</a>, and <a
+    href="#resettable" title=category-reset>resettable</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#field" title=category-field>Field element</a>.
-
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
@@ -27227,13 +27247,11 @@
 
    <dd><a href="#interactive1">Interactive content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a>, <a
+    href="#submittable" title=category-submit>submittable</a>, and <a
+    href="#resettable" title=category-reset>resettable</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#field" title=category-field>Field element</a>.
-
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
@@ -27317,11 +27335,10 @@
 
    <dd><a href="#phrasing0">Phrasing content</a>.
 
-   <dd><a href="#form-associated">Form-associated element</a>.
+   <dd><a href="#listed" title=category-listed>Listed</a> and <a
+    href="#resettable" title=category-reset>resettable</a> <a
+    href="#form-associated">form-associated element</a>.
 
-   <dd><a href="#listed" title=category-listed-form-element>Listed form
-    element</a>.
-
    <dt>Contexts in which this element may be used:
 
    <dd>Where <a href="#phrasing0">phrasing content</a> is expected.
@@ -27394,21 +27411,21 @@
   <p>When a <a href="#form-associated">form-associated element</a>'s ancestor
    chain changes, e.g. because it or one of its ancestors was inserted or
    removed from a <code>Document</code>, then the user agent must <a
-   href="#reset">reset the form owner</a> of that element.
+   href="#reset0">reset the form owner</a> of that element.
 
   <p>When a <a href="#form-associated">form-associated element</a>'s <code
    title=attr-fae-form><a href="#form0">form</a></code> attribute is added,
    removed, or has its value changed, then the user agent must <a
-   href="#reset">reset the form owner</a> of that element.
+   href="#reset0">reset the form owner</a> of that element.
 
   <p>When a <a href="#form-associated">form-associated element</a> has a
    <code title=attr-fae-form><a href="#form0">form</a></code> attribute and
    the ID of any of the <code><a href="#form">form</a></code> elements in the
    <code>Document</code> changes, then the user agent must <a
-   href="#reset">reset the form owner</a> of that <a
+   href="#reset0">reset the form owner</a> of that <a
    href="#form-associated">form-associated element</a>.
 
-  <p>When the user agent is to <dfn id=reset>reset the form owner</dfn> of a
+  <p>When the user agent is to <dfn id=reset0>reset the form owner</dfn> of a
    <a href="#form-associated">form-associated element</a>, it must run the
    following steps:
 
@@ -27568,10 +27585,10 @@
      is to perform the submission).
 
    <li>
-    <p>Let <var title="">controls</var> be a list of all the <a href="#field"
-     title=category-field>field elements</a> whose <a href="#form-owner">form
-     owner</a> is <var title="">form</var>, in <a href="#tree-order">tree
-     order</a>.
+    <p>Let <var title="">controls</var> be a list of all the <a
+     href="#submittable" title=category-submit>submittable</a> elements whose
+     <a href="#form-owner">form owner</a> is <var title="">form</var>, in <a
+     href="#tree-order">tree order</a>.
 
    <li>
     <p>Let the <var title="">form data set</var> be a list of name/value
@@ -28141,6 +28158,25 @@
    encoding. -->
   </ol>
 
+  <h4 id=resetting><span class=secno>4.9.17 </span>Resetting a form</h4>
+
+  <p>When a form <var title="">form</var> is <dfn id=reset1
+   title=concept-form-reset>reset</dfn>, the user agent must invoke the <a
+   href="#reset2" title=concept-form-reset-control>reset algorithm</a> of
+   each <a href="#resettable" title=category-reset>resettable</a> elements
+   whose <a href="#form-owner">form owner</a> is <var title="">form</var>,
+   and must then <a href="#dispatch">dispatch a <code
+   title=event-formchange>formchange</code> event</a>.
+
+  <p>Each <a href="#resettable" title=category-reset>resettable</a> element
+   defines its own <dfn id=reset2 title=concept-form-reset-control>reset
+   algorithm</dfn>.
+
+  <h4 id=event><span class=secno>4.9.18 </span>Event dispatch</h4>
+
+  <p class=big-issue>When the user agent is to <dfn id=dispatch>dispatch a
+   <code title=event-formchange>formchange</code> event</dfn>, ...
+
   <h3 id=scripting1><span class=secno>4.10 </span>Scripting</h3>
 
   <p>Scripts allow authors to add interactivity to their documents.
@@ -33968,7 +34004,7 @@
   void <a href="#postmessage0" title=dom-window-postMessage-2>postMessage</a>(in DOMString message, in DOMString targetOrigin);
   void <a href="#postmessage1" title=dom-window-postMessage-3>postMessage</a>(in DOMString message, in <a href="#messageport0">MessagePort</a> messagePort, in DOMString targetOrigin);
 
-  // <a href="#event6">event handler DOM attributes</a>
+  // <a href="#event7">event handler DOM attributes</a>
            attribute <span>EventListener</span> <a href="#onabort" title=handler-onabort>onabort</a>;
            attribute <span>EventListener</span> <a href="#onbeforeunload" title=handler-onbeforeunload>onbeforeunload</a>;
            attribute <span>EventListener</span> <a href="#onblur" title=handler-onblur>onblur</a>;
@@ -34257,7 +34293,7 @@
      <dd>The owner is the <code>Document</code> to which the <code><a
       href="#script1">script</a></code> element belongs.
 
-     <dt>If a script is in an <a href="#event5" title="event handler content
+     <dt>If a script is in an <a href="#event6" title="event handler content
       attributes">event handler content attribute</a>
 
      <dd>The owner is the <code>Document</code> to which the attribute node
@@ -34602,8 +34638,8 @@
     rule in a CSS <code><a href="#style1">style</a></code> element block).
 
    <li>Event handlers, whether registered through the DOM using <code
-    title="">addEventListener()</code>, by explicit <a href="#event5">event
-    handler content attributes</a>, by <a href="#event6">event handler DOM
+    title="">addEventListener()</code>, by explicit <a href="#event6">event
+    handler content attributes</a>, by <a href="#event7">event handler DOM
     attributes</a>, or otherwise.
 
    <li>Processing of technologies like XBL or SVG that have their own
@@ -34693,24 +34729,24 @@
    will disable any event handler attributes, event listeners, timeouts, etc,
    that were set by scripts in the document.
 
-  <h4 id=event><span class=secno>5.4.2 </span>Event loops</h4>
+  <h4 id=event0><span class=secno>5.4.2 </span>Event loops</h4>
 
   <p>To coordinate events, user interaction, scripts, rendering, networking,
-   and so forth, user agents must use <dfn id=event3 title="event loop">event
+   and so forth, user agents must use <dfn id=event4 title="event loop">event
    loops</dfn> as described in this section.
 
-  <p>There must be at least one <a href="#event3">event loop</a> per user
-   agent, and at most one <a href="#event3">event loop</a> per <a
+  <p>There must be at least one <a href="#event4">event loop</a> per user
+   agent, and at most one <a href="#event4">event loop</a> per <a
    href="#unit-of0">unit of related similar-origin browsing contexts</a>.
 
-  <p>An <a href="#event3">event loop</a> always has at least one <a
-   href="#browsing1">browsing context</a>. If an <a href="#event3">event
+  <p>An <a href="#event4">event loop</a> always has at least one <a
+   href="#browsing1">browsing context</a>. If an <a href="#event4">event
    loop</a>'s <a href="#browsing1" title="browsing context">browsing
-   contexts</a> all go away, then the <a href="#event3">event loop</a> goes
+   contexts</a> all go away, then the <a href="#event4">event loop</a> goes
    away as well. A <a href="#browsing1">browsing context</a> always has an <a
-   href="#event3">event loop</a> coordinating its activities.
+   href="#event4">event loop</a> coordinating its activities.
 
-  <p>An <a href="#event3">event loop</a> has one or more <dfn id=task-queues
+  <p>An <a href="#event4">event loop</a> has one or more <dfn id=task-queues
    title="task queue">task queues</dfn>. A <a href="#task-queues">task
    queue</a> is an ordered list of <dfn id=tasks
    title=concept-task>tasks</dfn>, which can be:
@@ -34753,7 +34789,7 @@
 
   <p>When a user agent is to <dfn id=queue>queue a task</dfn>, it must add
    the given task to one of the <a href="#task-queues" title="task
-   queue">task queues</a> of the relevant <a href="#event3">event loop</a>.
+   queue">task queues</a> of the relevant <a href="#event4">event loop</a>.
    All the tasks from one particular <dfn id=task-source>task source</dfn>
    (e.g. the callbacks generated by timers, the events dispatched for mouse
    movements, the tasks queued for the parser) must always be added to the
@@ -34770,12 +34806,12 @@
    starving other task queues, and never processing events from any one <a
    href="#task-source">task source</a> out of order.
 
-  <p>An <a href="#event3">event loop</a> must continually run through the
+  <p>An <a href="#event4">event loop</a> must continually run through the
    following steps for as long as it exists:
 
   <ol>
    <li>
-    <p>Run the oldest task on one of the <a href="#event3">event loop</a>'s
+    <p>Run the oldest task on one of the <a href="#event4">event loop</a>'s
      <a href="#task-queues" title="task queue">task queues</a>. The user
      agent may pick any <a href="#task-queues">task queue</a>.
 
@@ -34788,7 +34824,7 @@
      reflect the current state.
 
    <li>
-    <p>Return to the first step of the <a href="#event3">event loop</a>.
+    <p>Return to the first step of the <a href="#event4">event loop</a>.
   </ol>
 
   <h4 id=security4><span class=secno>5.4.3 </span>Security exceptions</h4>
@@ -34897,13 +34933,13 @@
    handler attributes</h5>
   <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0A...%3Cscript%3E%0Aw(a%3Ddocument.implementation.createDocument(null%2C%20null%2C%20null))%3B%0Aw(a.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'html')))%3B%0Aw(b%3Da.firstChild.appendChild(a.createElementNS('http%3A%2F%2Fwww.w3.org%2F1999%2Fxhtml'%2C%20'body')))%3B%0Aw(b.test%20%3D%20w)%3B%0Aw(b.setAttribute('onclick'%2C%20'test(%22fire%3A%20%22%20%2B%20event)'))%3B%0Aw(b.onclick)%3B%0Aw(e%3Da.createEvent('Event'))%3B%0Aw(e.initEvent('click'%2C%20false%2C%20false))%3B%0Aw(b.dispatchEvent(e))%3B%0A%3C%2Fscript%3E -->
 
-  <p><a href="#html-elements">HTML elements</a> can have <dfn id=event4>event
+  <p><a href="#html-elements">HTML elements</a> can have <dfn id=event5>event
    handler attributes</dfn> specified. These act as bubbling event listeners
    for the element on which they are specified.
 
-  <p>Each event handler attribute has two parts, an <a href="#event5"
+  <p>Each event handler attribute has two parts, an <a href="#event6"
    title="event handler content attributes">event handler content
-   attribute</a> and an <a href="#event6" title="event handler DOM
+   attribute</a> and an <a href="#event7" title="event handler DOM
    attributes">event handler DOM attribute</a>. Event handler attributes must
    initially be set to null. When their value changes (through the changing
    of their event handler content attribute or their event handler DOM
@@ -34911,11 +34947,11 @@
    <code>EventListener</code> object assigned to them.
 
   <p>Objects other than <code>Element</code> objects, in particular <code><a
-   href="#window">Window</a></code>, only have <a href="#event6" title="event
+   href="#window">Window</a></code>, only have <a href="#event7" title="event
    handler DOM attributes">event handler DOM attribute</a> (since they have
    no content attributes).
 
-  <p><dfn id=event5>Event handler content attributes</dfn>, when specified,
+  <p><dfn id=event6>Event handler content attributes</dfn>, when specified,
    must contain valid ECMAScript code matching the ECMAScript <code
    title="">FunctionBody</code> production. <a
    href="#refsECMA262">[ECMA262]</a></p>
@@ -34958,7 +34994,7 @@
 
   <p class=big-issue>How do we allow non-JS event handlers?
 
-  <p><dfn id=event6>Event handler DOM attributes</dfn>, on setting, must set
+  <p><dfn id=event7>Event handler DOM attributes</dfn>, on setting, must set
    the corresponding event handler attribute to their new value, and on
    getting, must return whatever the current value of the corresponding event
    handler attribute is (possibly null).
@@ -35314,7 +35350,7 @@
    otherwise. (The <var title=dom-event-listener>listener</var> argument is
    emphatically <em>not</em> the event handler attribute itself.)
 
-  <h5 id=event0><span class=secno>5.4.5.2. </span>Event firing</h5>
+  <h5 id=event1><span class=secno>5.4.5.2. </span>Event firing</h5>
 
   <p class=big-issue>maybe this should be moved higher up (terminology?
    conformance? DOM?) Also, the whole terminology thing should be changed so
@@ -37725,7 +37761,7 @@
      cache</var>.
   </ol>
 
-  <p>The following are the <a href="#event6">event handler DOM attributes</a>
+  <p>The following are the <a href="#event7">event handler DOM attributes</a>
    that must be supported by objects implementing the <code><a
    href="#applicationcache">ApplicationCache</a></code> interface:
 
@@ -39506,7 +39542,7 @@
    the two documents are in the same <a href="#unit-of">unit of related
    browsing contexts</a>, or null otherwise.
 
-  <h6 id=event1><span class=secno>5.10.1.5.1. </span>Event definition</h6>
+  <h6 id=event2><span class=secno>5.10.1.5.1. </span>Event definition</h6>
 
   <pre class=idl>interface <dfn id=storageevent>StorageEvent</dfn> : Event {
   readonly attribute DOMString <a href="#key" title=dom-StorageEvent-key>key</a>;
@@ -39557,11 +39593,11 @@
    executing, other than in a way that is predictable by the script itself.
 
   <p class=note>There are various ways of implementing this requirement. One
-   is to just have one <a href="#event3">event loop</a> for all <a
+   is to just have one <a href="#event4">event loop</a> for all <a
    href="#browsing1" title="browsing context">browsing contexts</a>. Another
    is that if a script running in one browsing context accesses a storage
    area, the user agent blocks scripts in other browsing contexts when they
-   try to access the same storage area until the <a href="#event3">event
+   try to access the same storage area until the <a href="#event4">event
    loop</a> running the first script has completed running the task that
    started that script. Another (potentially more efficient but certainly
    more complex) implementation strategy is to use optimistic transactional
@@ -44746,7 +44782,7 @@
 
   <h2 id=comms><span class=secno>7. </span>Communication</h2>
 
-  <h3 id=event2><span class=secno>7.1 </span>Event definitions</h3>
+  <h3 id=event3><span class=secno>7.1 </span>Event definitions</h3>
 
   <p>Messages in <a href="#server-sent">server-sent events</a>, <a
    href="#web-sockets">Web sockets</a>, <a
@@ -45160,7 +45196,7 @@
     <p>The field is ignored.
   </dl>
 
-  <p id=dispatchMessage>When the user agent is required to <dfn id=dispatch
+  <p id=dispatchMessage>When the user agent is required to <dfn id=dispatch0
    title="">dispatch the event</dfn>, then the user agent must act as
    follows:
 
@@ -45451,7 +45487,7 @@
 
   <hr>
 
-  <p>The following are the <a href="#event6">event handler DOM attributes</a>
+  <p>The following are the <a href="#event7">event handler DOM attributes</a>
    that must be supported by objects implementing the <code><a
    href="#websocket0">WebSocket</a></code> interface:
 
@@ -46743,7 +46779,7 @@
   <p>When a port's <a href="#port-message">port message queue</a> is open,
    contains an event, and its owner is <a href="#available" title="port owner
    available">available</a>, the user agent must <a href="#queue">queue a
-   task</a> in the <a href="#event3">event loop</a> to dispatch the first
+   task</a> in the <a href="#event4">event loop</a> to dispatch the first
    event in the queue on the <code><a
    href="#messageport0">MessagePort</a></code> object, and remove the event
    from the queue. The <a href="#task-source">task source</a> for this <a
@@ -46797,7 +46833,7 @@
 
   <hr>
 
-  <p>The following are the <a href="#event6">event handler DOM attributes</a>
+  <p>The following are the <a href="#event7">event handler DOM attributes</a>
    that must be supported by objects implementing the <code><a
    href="#messageport0">MessagePort</a></code> interface:
 
@@ -48656,7 +48692,7 @@
 
   <hr>
 
-  <p>When the steps below require the UA to <dfn id=reset0>reset the
+  <p>When the steps below require the UA to <dfn id=reset3>reset the
    insertion mode appropriately</dfn>, it means the UA must follow these
    steps:
 
@@ -53502,7 +53538,7 @@
     <p>Pop elements from this stack until a <code><a
      href="#table">table</a></code> element has been popped from the stack.</p>
 
-    <p><a href="#reset0">Reset the insertion mode appropriately</a>.</p>
+    <p><a href="#reset3">Reset the insertion mode appropriately</a>.</p>
 
    <dt>An end tag whose tag name is one of: "body", "caption", "col",
     "colgroup", "html", "tbody", "td", "tfoot", "th", "thead", "tr"
@@ -54106,7 +54142,7 @@
      until a <code><a href="#select">select</a></code> element has been
      popped from the stack.</p>
 
-    <p><a href="#reset0">Reset the insertion mode appropriately</a>.</p>
+    <p><a href="#reset3">Reset the insertion mode appropriately</a>.</p>
 
    <dt>A start tag whose tag name is "select"
 
@@ -55163,7 +55199,7 @@
      that it contains just the single element <var title="">root</var>.</p>
 
    <li>
-    <p><a href="#reset0" title="reset the insertion mode appropriately">Reset
+    <p><a href="#reset3" title="reset the insertion mode appropriately">Reset
      the parser's insertion mode appropriately</a>.</p>
 
     <p class=note>The parser will reference the <var title="">context</var>

Modified: source
===================================================================
--- source	2008-09-13 00:36:32 UTC (rev 2174)
+++ source	2008-09-13 01:03:43 UTC (rev 2175)
@@ -4583,7 +4583,8 @@
 
   <p>The <code>HTMLFormControlsCollection</code> interface represents
   a <span title="collections">collection</span> of <span
-  title="category-field">field elements</span>.</p>
+  title="category-listed">listed</span> elements in <code>form</code>
+  and <code>fieldset</code> elements.</p>
 
   <pre class="idl">interface <dfn>HTMLFormControlsCollection</dfn> {
   readonly attribute unsigned long <span title="dom-HTMLFormControlsCollection-length">length</span>;
@@ -23910,23 +23911,38 @@
   title="attr-fae-form">form</code> content attribute with a matching
   <code title="dom-fae-form">form</code> DOM attribute.</p>
 
-  <p>The controls that can end up being submitted back to the server
-  are <dfn title="category-field">field elements</dfn>.</p>
+  <p>The <span title="form-associated element">form-associated
+  elements</span> fall into several subcategories:</p>
 
-  <p>The controls that are exposed to the <code
-  title="dom-form-elements"><var title="">form</var>.elements</code>
-  and <code title="dom-fieldset-elements"><var
-  title="">fieldset</var>.elements</code> APIs are <dfn
-  title="category-listed-form-element">listed form
-  elements</dfn>. This is a superset of the <span
-  title="category-field">field elements</span>.</p>
+  <dl>
 
-  <p>Some <span title="category-field">field elements</span> can be,
-  depending on their attributes, <dfn
-  title="concept-button">buttons</dfn>. The prose below defines when
-  an element is a button.</p>
+   <dt><dfn title="category-submit">Submittable elements</dfn></dt>
 
+   <dd>Denotes elements that can be used for <a
+   href="#constructing-form-data-set">constructing the form data
+   set</a> when a <code>form</code> element is <span
+   title="concept-form-submit">submit</span>.</dd>
 
+   <dt><dfn title="category-reset">Resettable elements</dfn></dt>
+
+   <dd>Denotes elements that can be affected when a <code>form</code>
+   element is <span title="concept-form-reset">reset</span>.</dd>
+
+   <dt><dfn title="category-listed">Listed</dfn></dt>
+
+   <dd>Denotes elements that are listed in the <code
+   title="dom-form-elements"><var title="">form</var>.elements</code>
+   and <code title="dom-fieldset-elements"><var
+   title="">fieldset</var>.elements</code> APIs.</dd>
+
+  </dl>
+
+  <p>In addition, some <span
+  title="category-submit">submittable</span> can be, depending on
+  their attributes, <dfn title="concept-button">buttons</dfn>. The
+  prose below defines when an element is a button.</p>
+
+
   <h4>The <dfn><code>form</code></dfn> element</h4>
 
   <dl class="element">
@@ -23969,8 +23985,9 @@
   </dl>
 
   <p>The <code>form</code> element represents a collection of <span
-  title="category-field">data fields</span> that can be submitted to a
-  server for processing.</p>
+  title="form-associated element">form-associated elements</span>,
+  some of which can represent editable values that can be submitted to
+  a server for processing.</p>
 
   <p>The <dfn
   title="attr-form-accept-charset"><code>accept-charset</code></dfn>
@@ -24002,9 +24019,9 @@
   <p>The <dfn title="dom-form-elements"><code>elements</code></dfn>
   DOM attribute must return an <code>HTMLFormControlsCollection</code>
   rooted at the <code>Document</code> node, whose filter matches <span
-  title="category-listed-form-element">listed form elements</span>
-  whose <span>form owner</span> is the <code>form</code> element, with
-  the exception of <code>input</code> elements whose <code
+  title="category-listed">listed</span> elements whose <span>form
+  owner</span> is the <code>form</code> element, with the exception of
+  <code>input</code> elements whose <code
   title="attr-input-type">type</code> attribute is in the <span
   title="attr-input-type-image-state">Image Button</span> state, which
   must, for historical reasons, be excluded from this particular
@@ -24036,6 +24053,11 @@
   title="concept-form-submit">submit</span> the <code>form</code>
   element from the <code>form</code> element itself.</p>
 
+  <p>The <dfn title="dom-form-reset"><code>reset()</code></dfn>
+  method, when invoked, must <span
+  title="concept-form-reset">reset</span> the <code>form</code>
+  element.</p>
+
   <p class="big-issue">...</p>
 
 
@@ -24044,8 +24066,7 @@
   <dl class="element">
    <dt>Categories</dt>
    <dd><span>Flow content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>flow content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24080,8 +24101,8 @@
   title="dom-fieldset-elements"><code>elements</code></dfn> DOM
   attribute must return an <code>HTMLFormControlsCollection</code>
   rooted at the <code>Document</code> node, whose filter matches <span
-  title="category-listed-form-element">listed form elements</span>
-  that are descendants of the <code>fieldset</code> element.</p>
+  title="category-listed">listed</span> elements that are descendants
+  of the <code>fieldset</code> element.</p>
 
 
   <h4>The <dfn><code>input</code></dfn> element</h4>
@@ -24090,9 +24111,7 @@
    <dt>Categories</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dd><span>Interactive content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-field">Field element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span>, <span title="category-submit">submittable</span>, and <span title="category-reset">resettable</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>phrasing content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24190,9 +24209,7 @@
    <dt>Categories</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dd><span>Interactive content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-field">Field element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span> and <span title="category-submit">submittable</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>phrasing content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24269,9 +24286,7 @@
    <dt>Categories</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dd><span>Interactive content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-field">Field element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span>, <span title="category-submit">submittable</span>, and <span title="category-reset">resettable</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>phrasing content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24426,9 +24441,7 @@
    <dt>Categories</dt>
    <dd><span>Phrasing content</span>.</dd>
    <dd><span>Interactive content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-field">Field element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span>, <span title="category-submit">submittable</span>, and <span title="category-reset">resettable</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>phrasing content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24492,8 +24505,7 @@
   <dl class="element">
    <dt>Categories</dt>
    <dd><span>Phrasing content</span>.</dd>
-   <dd><span>Form-associated element</span>.</dd>
-   <dd><span title="category-listed-form-element">Listed form element</span>.</dd>
+   <dd><span title="category-listed">Listed</span> and <span title="category-reset">resettable</span> <span>form-associated element</span>.</dd>
    <dt>Contexts in which this element may be used:</dt>
    <dd>Where <span>phrasing content</span> is expected.</dd>
    <dt>Content model:</dt>
@@ -24709,8 +24721,8 @@
    the default action is to perform the submission).</p></li>
 
    <li><p>Let <var title="">controls</var> be a list of all the <span
-   title="category-field">field elements</span> whose <span>form
-   owner</span> is <var title="">form</var>, in <span>tree
+   title="category-submit">submittable</span> elements whose
+   <span>form owner</span> is <var title="">form</var>, in <span>tree
    order</span>.</p></li>
 
    <li><p>Let the <var title="">form data set</var> be a list of
@@ -25281,7 +25293,29 @@
 
 
 
+  <h4>Resetting a form</h4>
 
+  <p>When a form <var title="">form</var> is <dfn
+  title="concept-form-reset">reset</dfn>, the user agent must invoke
+  the <span title="concept-form-reset-control">reset algorithm</span>
+  of each <span title="category-reset">resettable</span> elements
+  whose <span>form owner</span> is <var title="">form</var>, and must
+  then <span>dispatch a <code
+  title="event-formchange">formchange</code> event</span>.</p>
+
+  <p>Each <span title="category-reset">resettable</span> element
+  defines its own <dfn title="concept-form-reset-control">reset
+  algorithm</dfn>.</p>
+
+
+
+  <h4>Event dispatch</h4>
+
+  <p class="big-issue">When the user agent is to <dfn>dispatch a <code
+  title="event-formchange">formchange</code> event</dfn>, ...</p>
+
+
+
   <h3>Scripting</h3>
 
   <p>Scripts allow authors to add interactivity to their documents.</p>




More information about the Commit-Watchers mailing list