[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