[e] (0) Disambiguate what document's load event is delayed. (credit: …

…roc) git-svn-id: http://svn.whatwg.org/webapps@3007 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Apr 28, 2009 · 955eab3 · 955eab3
1 parent acfcc2a
commit 955eab3
Show file tree

Hide file tree

Showing 2 changed files with 50 additions and 40 deletions.
diff --git a/index b/index
@@ -11515,7 +11515,8 @@ people expect to have work and what is necessary.
 
     </ol></dd>
 
-  </dl><p>Fetching an external script must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+  </dl><p>Fetching an external script must <a href=#delay-the-load-event>delay the load
+  event</a> of the element's document.</p>
 
   <p><dfn id=executing-a-script-block title="executing a script block">Executing a script
   block</dfn>: When the steps above require that the script block be
@@ -16796,7 +16797,8 @@ interface <dfn id=htmlimageelement>HTMLImageElement</dfn> : <a href=#htmlelement
   the <i>base URI of the element</i> is the same as <a href="#the-document's-address">the
   document's address</a>.</p>
 
-  <p>Fetching the image must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+  <p>Fetching the image must <a href=#delay-the-load-event>delay the load event</a> of the
+  element's document.</p>
 
   <p class=warning>This, unfortunately, can be used to perform a
   rudimentary port scan of the user's local network (especially in
@@ -18138,14 +18140,15 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   <code title=event-error><a href=#event-error>error</a></code> at the element instead.</p>
 
   <p>When there is an active parser in the <code><a href=#the-iframe-element>iframe</a></code>, and
-  when anything in the <code><a href=#the-iframe-element>iframe</a></code> that is <a href=#delay-the-load-event title="delay
-  the load event">delaying the <code title=event-load>load</code>
-  event</a> in the <code><a href=#the-iframe-element>iframe</a></code>'s <a href=#browsing-context>browsing
-  context</a>, the <code><a href=#the-iframe-element>iframe</a></code> must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+  when anything in the <code><a href=#the-iframe-element>iframe</a></code> is <a href=#delay-the-load-event title="delay the
+  load event">delaying the load event</a> of the
+  <code><a href=#the-iframe-element>iframe</a></code>'s <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active
+  document</a>, the <code><a href=#the-iframe-element>iframe</a></code> must <a href=#delay-the-load-event>delay the load
+  event</a> of its document.</p>
 
   <p class=note>If, during the handling of the <code title=event-load><a href=#event-load>load</a></code> event, the <a href=#browsing-context>browsing
   context</a> in the <code><a href=#the-iframe-element>iframe</a></code> is again <a href=#navigate title=navigate>navigated</a>, that will further <a href=#delay-the-load-event>delay the
-  <code title=event-load>load</code> event</a>.</p>
+  load event</a>.</p>
 
   </div>
 
@@ -18588,7 +18591,8 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   previously instantiated plugin for the element. <!-- Note that this
   doesn't happen when the base URL changes. --></p>
 
-  <p>Fetching the resource must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+  <p>Fetching the resource must <a href=#delay-the-load-event>delay the load event</a> of
+  the element's document.</p>
 
   <p>The <dfn id=concept-embed-type title=concept-embed-type>type of the content</dfn>
   being embedded is defined as follows:</p>
@@ -18816,7 +18820,8 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
       <p>If that is successful, <a href=#fetch>fetch</a> the resulting
       <a href=#absolute-url>absolute URL</a>.</p>
 
-      <p>The fetching of the resource must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+      <p>The fetching of the resource must <a href=#delay-the-load-event>delay the load
+      event</a> of the element's document.</p>
 
      </li>
 
@@ -19216,9 +19221,9 @@ href="?audio"&gt;audio&lt;/a&gt; test instead.)&lt;/p&gt;</pre>
   is set, its value must be <a href=#resolve-a-url title="resolve a
   url">resolved</a> relative to the element, and if that is
   successful, the resulting <a href=#absolute-url>absolute URL</a> must be <a href=#fetch title=fetch>fetched</a>; this must <a href=#delay-the-load-event>delay the load
-  event</a>. The <dfn id=poster-frame>poster frame</dfn> is then the image obtained
-  from that resource, if any.</span></p> <!-- thus it is unaffected by
-  changes to the base URL. -->
+  event</a> of the element's document. The <dfn id=poster-frame>poster frame</dfn>
+  is then the image obtained from that resource, if any.</span></p>
+  <!-- thus it is unaffected by changes to the base URL. -->
 
   <p class=note>The image given by the <code title=attr-video-poster><a href=#attr-video-poster>poster</a></code> attribute, the <i><a href=#poster-frame>poster
   frame</a></i>, is intended to be a representative frame of the video
@@ -20046,7 +20051,8 @@ interface <dfn id=cuerangecallback>CueRangeCallback</dfn> {
   <dfn id=autoplaying-flag>autoplaying flag</dfn>, which must begin in the true state, and
   a <dfn id=delaying-the-load-event-flag>delaying-the-load-event flag</dfn>, which must begin in the
   false state. While the <a href=#delaying-the-load-event-flag>delaying-the-load-event flag</a> is
-  true, the element must <a href=#delay-the-load-event>delay the load event</a>.</p>
+  true, the element must <a href=#delay-the-load-event>delay the load event</a> of its
+  document.</p>
 
   <p>When the <dfn id=dom-media-load title=dom-media-load><code>load()</code></dfn>
   method on a <a href=#media-element>media element</a> is invoked, the user agent
@@ -31563,7 +31569,8 @@ interface <dfn id=htmlformelement>HTMLFormElement</dfn> : <a href=#htmlelement>H
    <code title=attr-input-src><a href=#attr-input-src>src</a></code> attribute is set or
    changed.</li> <!-- XXX define changed -->
 
-  </ul><p>Fetching the image must <a href=#delay-the-load-event>delay the <code title=event-load>load</code> event</a>.</p>
+  </ul><p>Fetching the image must <a href=#delay-the-load-event>delay the load event</a> of the
+  element's document.</p>
 
   <p>If the image was successfully obtained, with no network errors,
   and the image's type is a supported image type, and the image is a
@@ -58430,8 +58437,8 @@ interface <dfn id=messageport>MessagePort</dfn> {
   <code>Document</code>.</p>
 
   <p>Once everything that <dfn id=delay-the-load-event title="delay the load event">delays the
-  load event</dfn> has completed, the user agent must run the
-  following steps:</p>
+  load event</dfn> of the document has completed, the user agent must
+  run the following steps:</p>
 
   <ol><li><a href=#queue-a-task>Queue a task</a> to set the <a href=#current-document-readiness>current document
    readiness</a> to "complete".</li>
@@ -58454,7 +58461,8 @@ interface <dfn id=messageport>MessagePort</dfn> {
   </ol><p>The <a href=#task-source>task source</a> for these tasks is the <a href=#dom-manipulation-task-source>DOM
   manipulation task source</a>.</p>
 
-  <!-- XXX make sure things "delay the load event" -->
+  <!-- XXX make sure things "delay the load event", e.g. applet and
+  object element's frame contents -->
 
   <p class=XXX>delaying the load event for things like image
   loads allows for intranet port scans (even without

diff --git a/source b/source
@@ -12264,8 +12264,8 @@ people expect to have work and what is necessary.
 
   </dl>
 
-  <p>Fetching an external script must <span>delay the <code
-  title="event-load">load</code> event</span>.</p>
+  <p>Fetching an external script must <span>delay the load
+  event</span> of the element's document.</p>
 
   <p><dfn title="executing a script block">Executing a script
   block</dfn>: When the steps above require that the script block be
@@ -18021,8 +18021,8 @@ interface <dfn>HTMLImageElement</dfn> : <span>HTMLElement</span> {
   the <i>base URI of the element</i> is the same as <span>the
   document's address</span>.</p>
 
-  <p>Fetching the image must <span>delay the <code
-  title="event-load">load</code> event</span>.</p>
+  <p>Fetching the image must <span>delay the load event</span> of the
+  element's document.</p>
 
   <p class="warning">This, unfortunately, can be used to perform a
   rudimentary port scan of the user's local network (especially in
@@ -19457,17 +19457,17 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   <code title="event-error">error</code> at the element instead.</p>
 
   <p>When there is an active parser in the <code>iframe</code>, and
-  when anything in the <code>iframe</code> that is <span title="delay
-  the load event">delaying the <code title="event-load">load</code>
-  event</span> in the <code>iframe</code>'s <span>browsing
-  context</span>, the <code>iframe</code> must <span>delay the <code
-  title="event-load">load</code> event</span>.</p>
+  when anything in the <code>iframe</code> is <span title="delay the
+  load event">delaying the load event</span> of the
+  <code>iframe</code>'s <span>browsing context</span>'s <span>active
+  document</span>, the <code>iframe</code> must <span>delay the load
+  event</span> of its document.</p>
 
   <p class="note">If, during the handling of the <code
   title="event-load">load</code> event, the <span>browsing
   context</span> in the <code>iframe</code> is again <span
   title="navigate">navigated</span>, that will further <span>delay the
-  <code title="event-load">load</code> event</span>.</p>
+  load event</span>.</p>
 
   </div>
 
@@ -19965,8 +19965,8 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   previously instantiated plugin for the element. <!-- Note that this
   doesn't happen when the base URL changes. --></p>
 
-  <p>Fetching the resource must <span>delay the <code
-  title="event-load">load</code> event</span>.</p>
+  <p>Fetching the resource must <span>delay the load event</span> of
+  the element's document.</p>
 
   <p>The <dfn title="concept-embed-type">type of the content</dfn>
   being embedded is defined as follows:</p>
@@ -20223,8 +20223,8 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
       <p>If that is successful, <span>fetch</span> the resulting
       <span>absolute URL</span>.</p>
 
-      <p>The fetching of the resource must <span>delay the <code
-      title="event-load">load</code> event</span>.</p>
+      <p>The fetching of the resource must <span>delay the load
+      event</span> of the element's document.</p>
 
      </li>
 
@@ -20663,9 +20663,9 @@ href="?audio">audio&lt;/a> test instead.)&lt;/p></pre>
   url">resolved</span> relative to the element, and if that is
   successful, the resulting <span>absolute URL</span> must be <span
   title="fetch">fetched</span>; this must <span>delay the load
-  event</span>. The <dfn>poster frame</dfn> is then the image obtained
-  from that resource, if any.</span></p> <!-- thus it is unaffected by
-  changes to the base URL. -->
+  event</span> of the element's document. The <dfn>poster frame</dfn>
+  is then the image obtained from that resource, if any.</span></p>
+  <!-- thus it is unaffected by changes to the base URL. -->
 
   <p class="note">The image given by the <code
   title="attr-video-poster">poster</code> attribute, the <i>poster
@@ -21615,7 +21615,8 @@ interface <dfn>CueRangeCallback</dfn> {
   <dfn>autoplaying flag</dfn>, which must begin in the true state, and
   a <dfn>delaying-the-load-event flag</dfn>, which must begin in the
   false state. While the <span>delaying-the-load-event flag</span> is
-  true, the element must <span>delay the load event</span>.</p>
+  true, the element must <span>delay the load event</span> of its
+  document.</p>
 
   <p>When the <dfn title="dom-media-load"><code>load()</code></dfn>
   method on a <span>media element</span> is invoked, the user agent
@@ -35202,8 +35203,8 @@ interface <dfn>HTMLFormElement</dfn> : <span>HTMLElement</span> {
 
   </ul>
 
-  <p>Fetching the image must <span>delay the <code
-  title="event-load">load</code> event</span>.</p>
+  <p>Fetching the image must <span>delay the load event</span> of the
+  element's document.</p>
 
   <p>If the image was successfully obtained, with no network errors,
   and the image's type is a supported image type, and the image is a
@@ -71218,8 +71219,8 @@ interface <dfn>MessagePort</dfn> {
   <code>Document</code>.</p>
 
   <p>Once everything that <dfn title="delay the load event">delays the
-  load event</dfn> has completed, the user agent must run the
-  following steps:</p>
+  load event</dfn> of the document has completed, the user agent must
+  run the following steps:</p>
 
   <ol>
 
@@ -71249,7 +71250,8 @@ interface <dfn>MessagePort</dfn> {
   <p>The <span>task source</span> for these tasks is the <span>DOM
   manipulation task source</span>.</p>
 
-  <!-- XXX make sure things "delay the load event" -->
+  <!-- XXX make sure things "delay the load event", e.g. applet and
+  object element's frame contents -->
 
   <p class="XXX">delaying the load event for things like image
   loads allows for intranet port scans (even without