HTML Standard Tracker

Diff (omit for latest revision)
Filter

Short URL: http://html5.org/r/7637

File a bug

SVNBugCommentTime (UTC)
763720549Try to clarify event handler stuff2013-01-05 19:58
Index: source
===================================================================
--- source	(revision 7636)
+++ source	(revision 7637)
@@ -86485,6 +86485,9 @@
   <p>Many objects can have <dfn>event handlers</dfn> specified. These act as non-capture event
   listeners for the object on which they are specified. <a href="#refsDOM">[DOM]</a></p>
 
+  <p>An <span title="event handlers">event handler</span> has a name, which always starts with
+  "<code title="">on</code>" and is followed by the name of the event for which it is intended.</p>
+
   <p>An <span title="event handlers">event handler</span> can either have the value null or be set
   to a callback object. This is defined using the <code>EventHandler</code> callback interface type.
   <span class="impl">Initially, event handlers must be set to null.</span></p>
@@ -86502,7 +86505,11 @@
 
   <hr>
 
-  <p><dfn>Event handler IDL attributes</dfn>, on setting, must set the corresponding event handler
+  <p>An <dfn title="event handler IDL attributes">event handler IDL attribute</dfn> is an IDL
+  attribute for a specific <span title="event handlers">event handler</span>. The name of the IDL
+  attribute is the same as the name of the <span title="event handlers">event handler</span>.</p>
+
+  <p><span>Event handler IDL attributes</span>, on setting, must set the corresponding event handler
   to their new value, and on getting, must return whatever the current value of the corresponding
   event handler is (possibly null).</p>
 
@@ -86519,7 +86526,7 @@
   <code>MessagePort</code> objects.</p>
 
   <p>On getting, <span>event handler IDL attributes</span> must return the value of their
-  corresponding event handlers, except when the value is an <span
+  corresponding <span>event handlers</span>, except when the value is an <span
   title="concept-handler-error">internal error value</span>, in which case the user agent must set
   the corresponding event handler to null, and then throw an exception corresponding to the error
   condition.</p>
@@ -86528,10 +86535,15 @@
 
   </div>
 
-  <p><dfn>Event handler content attributes</dfn>, when specified, must contain valid JavaScript code
-  which, when parsed, would match the <code title="">FunctionBody</code> production after automatic
-  semicolon insertion. <a href="#refsECMA262">[ECMA262]</a></p>
+  <p>An <dfn title="event handler content attributes">event handler content attribute</dfn> is a
+  content attribute for a specific <span title="event handlers">event handler</span>. The name of
+  the content attribute is the same as the name of the <span title="event handlers">event
+  handler</span>.</p>
 
+  <p><span>Event handler content attributes</span>, when specified, must contain valid JavaScript
+  code which, when parsed, would match the <code title="">FunctionBody</code> production after
+  automatic semicolon insertion. <a href="#refsECMA262">[ECMA262]</a></p>
+
   <div class="impl">
 
   <!-- SCRIPT EXEC -->

|