[html5] r844 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2007-05-24 15:03:50 -0700 (Thu, 24 May 2007)
New Revision: 844

Modified:
   index
   source
Log:
[] (0) Split the requirements on Function/EventListener from the requirement regarding event handler attributes return false to cancel.

Modified: index
===================================================================
--- index	2007-05-24 19:38:21 UTC (rev 843)
+++ index	2007-05-24 22:03:50 UTC (rev 844)
@@ -1551,6 +1551,8 @@
       3D scenes</a>
 
      <li><a href="#timers"><span class=secno>11.4. </span>Timers</a>
+
+     <li><a href="#events2"><span class=secno>11.5. </span>Events</a>
     </ul>
 
    <li class=no-num><a href="#references">References</a>
@@ -26088,21 +26090,6 @@
    handler DOM attributes">event handler DOM attribute</a> (since they have
    no content attributes).
 
-  <p id=js-function-listener>In the ECMAScript DOM binding, the ECMAScript
-   native <code>Function</code> type must implement the
-   <code>EventListener</code> interface such that invoking the
-   <code>handleEvent()</code> method of that interface on the object from
-   another language binding invokes the function itself, with the
-   <code>event</code> argument as its only argument. In the ECMAScript
-   binding itself, however, the <code>handleEvent()</code> method of the
-   interface is not directly accessible on <code>Function</code> objects.
-   Such functions, when invoked, must be called in the scope of the <a
-   href="#browsing0">browsing context</a> that they were created in. If the
-   function returns false, the event's <code>preventDefault()</code> method
-   must then invoked. Exception: for historical reasons, for the HTML
-   <code>mouseover</code> event, the <code>preventDefault()</code> method
-   must be called when the function returns true instead.
-
   <p><dfn id=event2>Event handler content attributes</dfn>, when specified,
    must contain valid ECMAScript code matching the ECMAScript <code
    title="">FunctionBody</code> production. <a
@@ -26439,6 +26426,14 @@
    <!-- XXX need to fire this -->
   </dl>
 
+  <p>When an event handler attribute is invoked, its argument must be set to
+   the <code>Event</code> object of the event in question. If the function
+   returns false, the event's <code>preventDefault()</code> method must then
+   invoked. Exception: for historical reasons, for the HTML
+   <code>mouseover</code> event, the <code>preventDefault()</code> method
+   must be called when the function returns true instead.</p>
+  <!-- IE actually uncancels the event if the function returns true -->
+
   <p>When <a href="#scripting1">scripting is disabled</a>, event handler
    attributes must do nothing.
 
@@ -38962,6 +38957,19 @@
   <p>Timeouts must never fire while another script is executing. (Thus the
    HTML scripting model is strictly single-threaded and not reentrant.)
 
+  <h3 id=events2><span class=secno>11.5. </span>Events</h3>
+
+  <p id=js-function-listener>In the ECMAScript DOM binding, the ECMAScript
+   native <code>Function</code> type must implement the
+   <code>EventListener</code> interface such that invoking the
+   <code>handleEvent()</code> method of that interface on the object from
+   another language binding invokes the function itself, with the
+   <code>event</code> argument as its only argument. In the ECMAScript
+   binding itself, however, the <code>handleEvent()</code> method of the
+   interface is not directly accessible on <code>Function</code> objects.
+   Such functions, when invoked, must be called in the scope of the <a
+   href="#browsing0">browsing context</a> that they were created in.
+
   <h2 class=no-num id=references>References</h2>
 
   <p class=big-issue>This section will be written in a future

Modified: source
===================================================================
--- source	2007-05-24 19:38:21 UTC (rev 843)
+++ source	2007-05-24 22:03:50 UTC (rev 844)
@@ -23578,22 +23578,6 @@
   attributes">event handler DOM attribute</span> (since they have no
   content attributes).</p>
 
-  <p id="js-function-listener">In the ECMAScript DOM binding, the
-  ECMAScript native <code>Function</code> type must implement the
-  <code>EventListener</code> interface such that invoking the
-  <code>handleEvent()</code> method of that interface on the object
-  from another language binding invokes the function itself, with the
-  <code>event</code> argument as its only argument. In the ECMAScript
-  binding itself, however, the <code>handleEvent()</code> method of
-  the interface is not directly accessible on <code>Function</code>
-  objects. Such functions, when invoked, must be called in the scope
-  of the <span>browsing context</span> that they were created in. If
-  the function returns false, the event's
-  <code>preventDefault()</code> method must then invoked. Exception:
-  for historical reasons, for the HTML <code>mouseover</code> event,
-  the <code>preventDefault()</code> method must be called when the
-  function returns true instead.</p>
-
   <p><dfn>Event handler content attributes</dfn>, when specified, must
   contain valid ECMAScript code matching the ECMAScript <code
   title="">FunctionBody</code> production. <a
@@ -23861,9 +23845,19 @@
    title="event-unload">unload</code> event is targeted at or bubbles
    through the element.</p></dd> <!-- XXX need to fire this -->
 
-
   </dl>
 
+  <p>When an event handler attribute is invoked, its argument must be
+  set to the <code>Event</code> object of the event in question. If
+  the function returns false, the event's
+  <code>preventDefault()</code> method must then invoked. Exception:
+  for historical reasons, for the HTML <code>mouseover</code> event,
+  the <code>preventDefault()</code> method must be called when the
+  function returns true instead.</p>
+
+  <!-- IE actually uncancels the event if the function returns true -->
+
+
   <p>When <span>scripting is disabled</span>, event handler attributes
   must do nothing.</p>
 
@@ -35593,7 +35587,22 @@
   reentrant.)</p>
 
 
+  <h3>Events</h3>
 
+  <p id="js-function-listener">In the ECMAScript DOM binding, the
+  ECMAScript native <code>Function</code> type must implement the
+  <code>EventListener</code> interface such that invoking the
+  <code>handleEvent()</code> method of that interface on the object
+  from another language binding invokes the function itself, with the
+  <code>event</code> argument as its only argument. In the ECMAScript
+  binding itself, however, the <code>handleEvent()</code> method of
+  the interface is not directly accessible on <code>Function</code>
+  objects. Such functions, when invoked, must be called in the scope
+  of the <span>browsing context</span> that they were created in.</p>
+
+
+
+
   <h2 class="no-num" id="references">References</h2>
 
   <p class="big-issue">This section will be written in a future