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

git-svn-id: http://svn.whatwg.org/webapps@4339 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Oct 27, 2009 · 3df6d41 · 3df6d41
1 parent 15a30bb
commit 3df6d41
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 2 deletions.
diff --git a/complete.html b/complete.html
@@ -7933,6 +7933,11 @@ <h4 id=global-attributes><span class=secno>3.2.3 </span><dfn>Global attributes</
   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>

diff --git a/index b/index
@@ -7743,6 +7743,11 @@ interface <dfn id=htmlunknownelement>HTMLUnknownElement</dfn> : <a href=#htmlele
   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 @@ interface <a href=#htmldocument>HTMLDocument</a> {
 
     <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>

diff --git a/source b/source
@@ -7828,6 +7828,12 @@ interface <dfn>HTMLUnknownElement</dfn> : <span>HTMLElement</span> { };</pre>
   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 @@ interface <span>HTMLDocument</span> {
     <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>