Short URL: http://html5.org/r/7637
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 7637 | 20549 | Try to clarify event handler stuff | 2013-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 -->