[html5] r4339 - [e] (0) Some clarifications about events and event handler attributes.

[whatwg at whatwg.org]

Author: ianh
Date: 2009-10-26 23:08:32 -0700 (Mon, 26 Oct 2009)
New Revision: 4339

Modified:
   complete.html
   index
   source
Log:
[e] (0) Some clarifications about events and event handler attributes.

Modified: complete.html
===================================================================
--- complete.html	2009-10-27 02:05:20 UTC (rev 4338)
+++ complete.html	2009-10-27 06:08:32 UTC (rev 4339)
@@ -7933,6 +7933,11 @@
   those elements expose <a href=#event-handlers>event handlers</a> of the
   <code><a href=#window>Window</a></code> object with the same names.</p>
 
+  <p class=note>While these attributes apply to all elements, they
+  are not useful on all elements. For example, only <a href=#media-element title="media
+  element">media elements</a> will ever receive a <code title=event-media-volumechange><a href=#event-media-volumechange>volumechange</a></code> event fired by
+  the user agent.</p>
+
   <hr><p><a href=#custom-data-attribute title="custom data attribute">Custom data attributes</a>
   (e.g. <code title="">data-foldername</code> or <code title="">data-msgid</code>) can be specified on any <a href=#html-elements title="HTML elements">HTML element</a>, to store custom data
   specific to the page.</p>

Modified: index
===================================================================
--- index	2009-10-27 02:05:20 UTC (rev 4338)
+++ index	2009-10-27 06:08:32 UTC (rev 4339)
@@ -7743,6 +7743,11 @@
   those elements expose <a href=#event-handlers>event handlers</a> of the
   <code><a href=#window>Window</a></code> object with the same names.</p>
 
+  <p class=note>While these attributes apply to all elements, they
+  are not useful on all elements. For example, only <a href=#media-element title="media
+  element">media elements</a> will ever receive a <code title=event-media-volumechange><a href=#event-media-volumechange>volumechange</a></code> event fired by
+  the user agent.</p>
+
   <hr><p><a href=#custom-data-attribute title="custom data attribute">Custom data attributes</a>
   (e.g. <code title="">data-foldername</code> or <code title="">data-msgid</code>) can be specified on any <a href=#html-elements title="HTML elements">HTML element</a>, to store custom data
   specific to the page.</p>
@@ -77310,7 +77315,7 @@
 
     <tr><td> <code title=event-load>load</code>
      <td> <code>Event</code>
-     <td> Fired when a resource has finished loading
+     <td> Fired at the <code><a href=#window>Window</a></code> when the document has finished loading; fired at an element containing a resource (e.g. <code><a href=#the-img-element>img</a></code>, <code><a href=#the-embed-element>embed</a></code>) when its resource has finished loading
 
     <tr><td> <code title=event-message><a href=#event-message>message</a></code>
      <td> <code><a href=#messageevent>MessageEvent</a></code>

Modified: source
===================================================================
--- source	2009-10-27 02:05:20 UTC (rev 4338)
+++ source	2009-10-27 06:08:32 UTC (rev 4339)
@@ -7828,6 +7828,12 @@
   those elements expose <span>event handlers</span> of the
   <code>Window</code> object with the same names.</p>
 
+  <p class="note">While these attributes apply to all elements, they
+  are not useful on all elements. For example, only <span title="media
+  element">media elements</span> will ever receive a <code
+  title="event-media-volumechange">volumechange</code> event fired by
+  the user agent.</p>
+
   <hr>
 
   <p><span title="custom data attribute">Custom data attributes</span>
@@ -95298,7 +95304,7 @@
     <tr>
      <td> <code title="event-load">load</code>
      <td> <code>Event</code>
-     <td> Fired when a resource has finished loading
+     <td> Fired at the <code>Window</code> when the document has finished loading; fired at an element containing a resource (e.g. <code>img</code>, <code>embed</code>) when its resource has finished loading
 
     <tr>
      <td> <code title="event-message">message</code>