--- a/html/DOM3-Events.html Tue Nov 12 17:40:14 2013 +0800
+++ b/html/DOM3-Events.html Wed Nov 13 03:14:55 2013 +0800
@@ -9268,34 +9268,52 @@
<section id="changes-DOMEvents2to3Changes">
<h2>Changes between DOM Level 2 Events and DOM Level 3 Events</h2>
- <p>Numerous clarifications to the interfaces and event types have been made. The <code>HTMLEvents</code> module is no longer defined in this document. The event types
- <a class="eventtype"><code>focus</code></a> and <a class="eventtype"><code>blur</code></a> have been added to the <a href="#interface-UIEvent"><code>UIEvent</code></a>
- module, the event type <a class="eventtype"><code>dblclick</code></a> has been added to the <a href="#interface-MouseEvent"><code>MouseEvent</code></a> module. This new
- specification provides a better separation between the DOM event flow, the event types, and the DOM interfaces.</p>
+ <p>Numerous clarifications to the interfaces and event types have been made.
+ The <code>HTMLEvents</code> module is no longer defined in this document.
+ The <a class="eventtype"><code>focus</code></a> and <a class="eventtype"><code>blur</code></a>
+ events have been added to the <a href="#interface-UIEvent"><code>UIEvent</code></a>
+ module, and the <a class="eventtype"><code>dblclick</code></a> event has been added to the
+ <a href="#interface-MouseEvent"><code>MouseEvent</code></a> module.
+ This new specification provides a better separation between the DOM event flow,
+ the event types, and the DOM interfaces.
+ </p>
<section id="changes-DOMEvents2to3Changes-flow">
<h3>Changes to DOM Level 2 event flow</h3>
- <p>This new specification introduced the following new concepts in the event flow:</p>
+ <p>This new specification introduced the following new concepts in the event flow:
+ </p>
<ul>
- <li>ordering of event listeners: event listeners are now ordered while ordering was unspecified in DOM Level 2 Events.</li>
- <li>the event flow now includes the <a class="def" href="#glossary-defaultView">defaultView</a> (or <code>window</code>), to reflect existing implementations.</li>
+ <li>Event listeners are now ordered. In DOM Level 2, the event ordering was unspecified.</li>
+ <li>The event flow now includes the <a class="def" href="#glossary-defaultView">defaultView</a>
+ (or <code>window</code>), to reflect existing implementations.</li>
</ul>
</section>
<section id="changes-DOMEvents2to3Changes-event-types">
<h3>Changes to DOM Level 2 event types</h3>
- <p>Many clarifications have been made on the event types. The conformance is now explicitly defined against the event types, and not only in terms of interfaces used
- by the event types.</p>
-
- <p><code>"MutationEvents"</code> have been deprecated. Support for namespaced events, present in early drafts of this specification, has also been removed.</p>
-
- <p>For user agents which support the <a class="eventtype" href="#event-type-DOMNodeInserted"><code>DOMNodeInserted</code></a> and <a class="eventtype" href="#event-type-DOMNodeRemoved">
- <code>DOMNodeRemoved</code></a> event types, this specification no longer requires that the event type be fired for <code>Attr</code> nodes.</p>
-
- <p>The <a class="eventtype"><code>resize</code></a> event type no longer bubbles, reflecting existing implementations.</p>
+ <p>Many clarifications have been made on the event types.
+ The conformance is now explicitly defined against the event types, and not only in terms
+ of interfaces used by the event types.
+ </p>
+
+ <p><code>"MutationEvents"</code> have been deprecated.
+ Support for namespaced events, present in early drafts of this specification, has also been removed.
+ </p>
+
+ <p>For user agents which support the
+ <a class="eventtype" href="#event-type-DOMNodeInserted"><code>DOMNodeInserted</code></a>
+ and
+ <a class="eventtype" href="#event-type-DOMNodeRemoved"><code>DOMNodeRemoved</code></a>
+ event types, this specification no longer requires that the event type be fired for
+ <code>Attr</code> nodes.
+ </p>
+
+ <p>The <a class="eventtype"><code>resize</code></a> event type no longer bubbles, reflecting existing
+ implementations.
+ </p>
</section>
<section id="changes-DOMLevel2to3Changes">
@@ -9303,22 +9321,37 @@
<dl>
<dt>Interface <a href="#interface-Event"><code>Event</code></a></dt>
- <dd>The <a href="#interface-Event"><code>Event</code></a> interface has one new attribute, <a href="#widl-Event-defaultPrevented"><code>Event.defaultPrevented</code></a>,
- and one new method, <a href="#widl-Event-stopImmediatePropagation"><code>Event.stopImmediatePropagation()</code></a>.<br />
- <a href="#widl-Event-timeStamp"><code>Event.timeStamp</code></a> is now a <code>Number</code> in the ECMAScript binding. A proposed correction to make the
- same change in [<cite><a class="normative" href="#references-DOMCore">DOM3 Core</a></cite>] is forthcoming.<br />
- DOM Level 3 Events considers the <a href="#widl-Event-type"><code>Event.type</code></a> attribute to be case-sensitive, while DOM Level 2 Events considers
- <a href="#widl-Event-type"><code>Event.type</code></a> to be case-insensitive.</dd>
+ <dd>The <a href="#interface-Event"><code>Event</code></a> interface has one new attribute,
+ <a href="#widl-Event-defaultPrevented"><code>Event.defaultPrevented</code></a>,
+ and one new method,
+ <a href="#widl-Event-stopImmediatePropagation"><code>Event.stopImmediatePropagation()</code></a>.
+ <br />
+ <a href="#widl-Event-timeStamp"><code>Event.timeStamp</code></a> is now a <code>Number</code>
+ in the ECMAScript binding.
+ A proposed correction to make the same change in
+ [<cite><a class="normative" href="#references-DOMCore">DOM3 Core</a></cite>] is forthcoming.
+ <br />
+ DOM Level 3 Events considers the <a href="#widl-Event-type"><code>Event.type</code></a> attribute
+ to be case-sensitive, while DOM Level 2 Events considers
+ <a href="#widl-Event-type"><code>Event.type</code></a> to be case-insensitive.
+ </dd>
<dt>Interface <a href="#interface-EventTarget"><code>EventTarget</code></a></dt>
- <dd>The method <a href="#widl-EventTarget-dispatchEvent"><code>EventTarget.dispatchEvent()</code></a> was modified.</dd>
+ <dd>The method <a href="#widl-EventTarget-dispatchEvent"><code>EventTarget.dispatchEvent()</code></a>
+ was modified.
+ </dd>
<dt>Interface <a href="#interface-MouseEvent"><code>MouseEvent</code></a></dt>
- <dd>The <a href="#interface-MouseEvent"><code>MouseEvent</code></a> interface has one new method <a href="#widl-MouseEvent-getModifierState"><code>MouseEvent.getModifierState()</code></a>.</dd>
+ <dd>The <a href="#interface-MouseEvent"><code>MouseEvent</code></a> interface has one new method
+ <a href="#widl-MouseEvent-getModifierState"><code>MouseEvent.getModifierState()</code></a>.
+ </dd>
<dt>Exception <code>EventException</code></dt>
- <dd>The exception <code>EventException</code> <a href="#note-eventexcpetion-removed">is removed in this specification</a>. The prior <code>DISPATCH_REQUEST_ERR</code>
- code is re-mapped to a <code>DOMException</code> of type <code>InvalidStateError</code>.</dd>
+ <dd>The exception <code>EventException</code> <a href="#note-eventexcpetion-removed">is removed in this
+ specification</a>.
+ The prior <code>DISPATCH_REQUEST_ERR</code> code is re-mapped to a <code>DOMException</code> of type
+ <code>InvalidStateError</code>.
+ </dd>
</dl>
</section>
@@ -9331,43 +9364,67 @@
<a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a>,
<a href="#interface-CompositionEvent"><code>CompositionEvent</code></a>,
and <a href="#interface-WheelEvent"><code>WheelEvent</code></a>
- were added to the Events module.</p>
+ were added to the Events module.
+ </p>
</section>
</section>
<section id="changes-drafts">
<h2>Changes between different drafts of DOM Level 3 Events</h2>
- <p>The DOM Level 3 Events document was previously developed between 2000 and 2003, and and published as a W3C Note, pending further feedback and interest from implementers.
- In 2006, it was picked up for revision and progress on the Recommendation Track, and is now being revised to reflect the current state of implementation and the
- needs of script authors.</p>
-
- <p>Despite its status only as a W3C Note, rather than an official Recommendation, DOM 3 Events saw some implementation, and reference by other specifications, so care
- is being taken to cause minimal disruption, while still adapting the specification to the current environment.</p>
-
- <p>This specification has been reordered significantly from the earlier W3C Note form, and from the structure of DOM2 Events, in order to clarify the material. New
- diagrams have been put in place to represent hierarchies and events flows more clearly. Here are some of the more important changes between drafts:</p>
+ <p>The DOM Level 3 Events document was originally developed between 2000 and 2003, and published
+ as a W3C Note, pending further feedback and interest from implementers.
+ In 2006, it was picked up for revision and progress on the Recommendation Track, and was
+ then revised to reflect the current state of implementation and the
+ needs of script authors.
+ </p>
+
+ <p>Despite its status only as a W3C Note, rather than an official Recommendation, DOM 3 Events
+ saw some implementation, and was also referenced by other specifications, so care
+ is being taken to cause minimal disruption, while still adapting the specification to the
+ current environment.
+ </p>
+
+ <p>The current specification has been reordered significantly from the earlier W3C Note form,
+ and also from the structure of DOM2 Events, in order to clarify the material.
+ New diagrams have been put in place to represent hierarchies and events flows more clearly.
+ Here are some of the more important changes between drafts:
+ </p>
<ul>
- <li>The <q>key identifier</q> feature has been renamed <q>key value</q> to disambiguate them from unique identifiers for keys.</li>
+ <li>The <q>key identifier</q> feature has been renamed <q>key value</q> to disambiguate
+ them from unique identifiers for keys.
+ </li>
<li>The
<a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a>
- was briefly (from 2003-2010) defined to have <code>keyIdentifier</code> and <code>keyLocation</code> attributes, but these
- were removed in favor of the current
+ interface was briefly (from 2003-2010) defined to have <code>keyIdentifier</code>
+ and <code>keyLocation</code> attributes, but these were removed in favor of the current
<a href="#widl-KeyboardEvent-key"><code>key</code></a>
and <a href="#widl-KeyboardEvent-location"><code>location</code></a>
- attributes. These attributes were not widely implemented.</li>
- <li>The <a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a> also had a <code>char</code> attribute that was only used by the
+ attributes. These attributes were not widely implemented.
+ </li>
+ <li>The <a href="#interface-KeyboardEvent"><code>KeyboardEvent</code></a> also had a <code>char</code>
+ attribute that was only used by the
<a class="eventtype" href="#event-type-keypress"><code>keypress</code></a>
- event. Since the keypress event has been deprecated, this attribute was no longer useful and was removed.</li>
- <li>The <code>change</code>, <code>submit</code>, and <code>reset</code> events were removed, since they were specific to HTML forms, and are specified in [<cite><a
- class="informative" href="#references-HTML5">HTML5</a></cite>].</li>
- <li>The <code>textInput</code> event, originally proposed as a replacement for <a class="eventtype" href="#event-type-keypress"><code>keypress</code></a>, was
- removed in favor of the current <a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a>
- and <a class="eventtype" href="#event-type-input"><code>input</code></a> events.</li>
- <li>Namespaced events have been removed.</li>
- <li>Updated to use <a href="#references-WebIDL">Web IDL</a>.</li>
- <li>EventException has been removed.</li>
+ event. Since the keypress event has been deprecated, this attribute was no longer useful
+ and was removed.
+ </li>
+ <li>The <code>change</code>, <code>submit</code>, and <code>reset</code> events were removed,
+ since they were specific to HTML forms, and are specified in
+ [<cite><a class="informative" href="#references-HTML5">HTML5</a></cite>].
+ </li>
+ <li>The <code>textInput</code> event, originally proposed as a replacement for
+ <a class="eventtype" href="#event-type-keypress"><code>keypress</code></a>, was
+ removed in favor of the current
+ <a class="eventtype" href="#event-type-beforeinput"><code>beforeinput</code></a>
+ and <a class="eventtype" href="#event-type-input"><code>input</code></a> events.
+ </li>
+ <li>Namespaced events have been removed.
+ </li>
+ <li>Updated to use <a href="#references-WebIDL">Web IDL</a>.
+ </li>
+ <li>EventException has been removed.
+ </li>
</ul>
</section>
</section> <!-- changes-from-earlier-versions -->