[html5] r7637 - [e] (0) Try to clarify event handler stuff Fixing https://www.w3.org/Bugs/Public [...]
whatwg at whatwg.org
whatwg at whatwg.org
Sat Jan 5 11:58:16 PST 2013
Author: ianh
Date: 2013-01-05 11:58:15 -0800 (Sat, 05 Jan 2013)
New Revision: 7637
Modified:
complete.html
index
source
Log:
[e] (0) Try to clarify event handler stuff
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20549
Affected topics: HTML
Modified: complete.html
===================================================================
--- complete.html 2013-01-04 00:49:51 UTC (rev 7636)
+++ complete.html 2013-01-05 19:58:15 UTC (rev 7637)
@@ -248,7 +248,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 4 January 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 5 January 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -73967,6 +73967,9 @@
<p>Many objects can have <dfn id=event-handlers>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 <a href=#event-handlers title="event handlers">event handler</a> 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 <a href=#event-handlers title="event handlers">event handler</a> can either have the value null or be set
to a callback object. This is defined using the <code><a href=#eventhandler>EventHandler</a></code> callback interface type.
<span class=impl>Initially, event handlers must be set to null.</span></p>
@@ -73982,7 +73985,11 @@
<div class=impl>
- <hr><p><dfn id=event-handler-idl-attributes>Event handler IDL attributes</dfn>, on setting, must set the corresponding event handler
+ <hr><p>An <dfn id=event-handler-idl-attributes title="event handler IDL attributes">event handler IDL attribute</dfn> is an IDL
+ attribute for a specific <a href=#event-handlers title="event handlers">event handler</a>. The name of the IDL
+ attribute is the same as the name of the <a href=#event-handlers title="event handlers">event handler</a>.</p>
+
+ <p><a href=#event-handler-idl-attributes>Event handler IDL attributes</a>, 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>
@@ -73999,16 +74006,21 @@
<code><a href=#messageport>MessagePort</a></code> objects.</p>
<p>On getting, <a href=#event-handler-idl-attributes>event handler IDL attributes</a> must return the value of their
- corresponding event handlers, except when the value is an <a href=#concept-handler-error title=concept-handler-error>internal error value</a>, in which case the user agent must set
+ corresponding <a href=#event-handlers>event handlers</a>, except when the value is an <a href=#concept-handler-error title=concept-handler-error>internal error value</a>, 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>
<hr></div>
- <p><dfn id=event-handler-content-attributes>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 id=event-handler-content-attributes title="event handler content attributes">event handler content attribute</dfn> is a
+ content attribute for a specific <a href=#event-handlers title="event handlers">event handler</a>. The name of
+ the content attribute is the same as the name of the <a href=#event-handlers title="event handlers">event
+ handler</a>.</p>
+ <p><a href=#event-handler-content-attributes>Event handler content attributes</a>, 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 -->
Modified: index
===================================================================
--- index 2013-01-04 00:49:51 UTC (rev 7636)
+++ index 2013-01-05 19:58:15 UTC (rev 7637)
@@ -248,7 +248,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
- <h2 class="no-num no-toc">Living Standard — Last Updated 4 January 2013</h2>
+ <h2 class="no-num no-toc">Living Standard — Last Updated 5 January 2013</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
@@ -73967,6 +73967,9 @@
<p>Many objects can have <dfn id=event-handlers>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 <a href=#event-handlers title="event handlers">event handler</a> 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 <a href=#event-handlers title="event handlers">event handler</a> can either have the value null or be set
to a callback object. This is defined using the <code><a href=#eventhandler>EventHandler</a></code> callback interface type.
<span class=impl>Initially, event handlers must be set to null.</span></p>
@@ -73982,7 +73985,11 @@
<div class=impl>
- <hr><p><dfn id=event-handler-idl-attributes>Event handler IDL attributes</dfn>, on setting, must set the corresponding event handler
+ <hr><p>An <dfn id=event-handler-idl-attributes title="event handler IDL attributes">event handler IDL attribute</dfn> is an IDL
+ attribute for a specific <a href=#event-handlers title="event handlers">event handler</a>. The name of the IDL
+ attribute is the same as the name of the <a href=#event-handlers title="event handlers">event handler</a>.</p>
+
+ <p><a href=#event-handler-idl-attributes>Event handler IDL attributes</a>, 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>
@@ -73999,16 +74006,21 @@
<code><a href=#messageport>MessagePort</a></code> objects.</p>
<p>On getting, <a href=#event-handler-idl-attributes>event handler IDL attributes</a> must return the value of their
- corresponding event handlers, except when the value is an <a href=#concept-handler-error title=concept-handler-error>internal error value</a>, in which case the user agent must set
+ corresponding <a href=#event-handlers>event handlers</a>, except when the value is an <a href=#concept-handler-error title=concept-handler-error>internal error value</a>, 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>
<hr></div>
- <p><dfn id=event-handler-content-attributes>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 id=event-handler-content-attributes title="event handler content attributes">event handler content attribute</dfn> is a
+ content attribute for a specific <a href=#event-handlers title="event handlers">event handler</a>. The name of
+ the content attribute is the same as the name of the <a href=#event-handlers title="event handlers">event
+ handler</a>.</p>
+ <p><a href=#event-handler-content-attributes>Event handler content attributes</a>, 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 -->
Modified: source
===================================================================
--- source 2013-01-04 00:49:51 UTC (rev 7636)
+++ source 2013-01-05 19:58:15 UTC (rev 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 -->
More information about the Commit-Watchers
mailing list