[html5] r5198 - [giow] (2) Reluctantly define document.load().

whatwg at whatwg.org whatwg at whatwg.org
Mon Jul 26 22:36:08 PDT 2010


Author: ianh
Date: 2010-07-26 22:36:07 -0700 (Mon, 26 Jul 2010)
New Revision: 5198

Modified:
   complete.html
   index
   source
Log:
[giow] (2) Reluctantly define document.load().

Modified: complete.html
===================================================================
--- complete.html	2010-07-23 23:21:01 UTC (rev 5197)
+++ complete.html	2010-07-27 05:36:07 UTC (rev 5198)
@@ -209,7 +209,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Draft Standard — 23 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 27 July 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -85704,6 +85704,7 @@
 tfoot, tfoot[hidden] { display: table-footer-group; }
 tr, tr[hidden] { display: table-row; }
 td, th, td[hidden], th[hidden] { display: table-cell; }
+
 colgroup[hidden], col[hidden], thead[hidden], tbody[hidden],
 tfoot[hidden], tr[hidden], td[hidden], th[hidden] {
   visibility: collapse;

Modified: index
===================================================================
--- index	2010-07-23 23:21:01 UTC (rev 5197)
+++ index	2010-07-27 05:36:07 UTC (rev 5198)
@@ -213,7 +213,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>HTML5 (including next generation additions still in development)</h1>
-    <h2 class="no-num no-toc">Draft Standard — 23 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 27 July 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -78750,6 +78750,7 @@
 tfoot, tfoot[hidden] { display: table-footer-group; }
 tr, tr[hidden] { display: table-row; }
 td, th, td[hidden], th[hidden] { display: table-cell; }
+
 colgroup[hidden], col[hidden], thead[hidden], tbody[hidden],
 tfoot[hidden], tr[hidden], td[hidden], th[hidden] {
   visibility: collapse;

Modified: source
===================================================================
--- source	2010-07-23 23:21:01 UTC (rev 5197)
+++ source	2010-07-27 05:36:07 UTC (rev 5198)
@@ -8710,7 +8710,129 @@
   </div>
 
 
+  <div class="impl"> <!-- very deprecated API; use XHR instead -->
 
+  <h4>Loading XML documents</h4>
+
+  <p>A <code>Document</code> object that is an <span title="XML
+  documents">XML document</span> must also implement the
+  <code>XMLDocumentLoader</code> interface:</p>
+
+  <pre class="idl">[Supplemental, NoInterfaceObject]
+interface <dfn>XMLDocumentLoader</dfn> {
+           attribute boolean <span title="dom-XMLDocumentLoader-async">async</span>;
+  boolean <span title="dom-XMLDocumentLoader-load">load</span>(in DOMString url);
+};</pre>
+
+  <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/576 -->
+  <!-- http://software.hixie.ch/utilities/js/live-dom-viewer/saved/577 -->
+  <!-- http://www.hixie.ch/tests/adhoc/dom/level0/document/load/001.html -->
+
+  <p>The <dfn
+  title="dom-XMLDocumentLoader-async"><code>async</code></dfn>
+  attribute must initially be true. On getting, it must return its
+  current value. On setting, its current value must be changed to the
+  new value.</p>
+
+  <p>The <dfn title="dom-XMLDocumentLoader-load"><code>load(<var
+  title="">url</var>)</code></dfn> method must run the following
+  steps:</p>
+
+  <ol>
+
+   <li><p>Let <var title="">document</var> be the <code>Document</code>
+   object on which the method was invoked.</p>~</li>
+
+   <li><p>If the <span>origin</var> of <var title="">url</var> is not
+   the same as the <span>origin</span> of <var
+   title="">document</var>, throw a <code>SECURITY_ERR</code>
+   exception.</p></li>
+
+   <li><p>Remove all child nodes of <var title="">document</var>,
+   without firing any mutation events.</p></li> <!-- as of 2010-07-26,
+   only Opera fired mutation events here. -->
+
+   <li><p>Set the <span>current document readiness</span> of <var
+   title="">document</var> to "loading".</p></li>
+
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code> is
+   set to true, then run the remainder of these steps asynchronously,
+   and return true from the method. Otherwise, continue running these
+   steps without yet returning.</p></li>
+
+   <li><p>Let <var title="">result</var> be an <code>Document</code>
+   object.</p></li>
+
+   <li><p>Let <var title="">success</var> be false.</p></li>
+
+   <li><p><span>Fetch</span> <var title="">url</var> from the
+   <span>origin</span> of <var title="">document</var>, with the <var
+   title="">synchronous flag</var> set and the <var title="">force
+   same-origin flag</var> set.</p></li>
+
+   <li>
+
+    <p>If the fetch attempt was successful, and the resource's <span
+    title="Content-Type">Content-Type metadata</span> is an <span>XML
+    MIME type</span>, then run these substeps:</p>
+
+    <ol>
+
+     <li><p>Create a new <span>XML parser</span> associated with the
+     <var title="">result</var> document.</p></li>
+
+     <li><p>Pass this parser the fetched document.</p></li> <!-- no
+     worries about scripts running; there's no browsing context for
+     the document so scripts are automatically disabled -->
+
+     <li><p>If there is an XML well-formedness or XML namespace
+     well-formedness error, then remove all child nodes from <var
+     title="">result</var>. Otherwise let <var title="">success</var>
+     be true.</p></li>
+
+    </ol>
+
+   </li>
+
+   <li>
+
+    <p>If <code title="dom-XMLDocumentLoader-async">async</code> is
+    set to true, then <span>queue a task</span> to run the following
+    steps. Otherwise, run them synchronously.</p>
+
+    <ol>
+
+     <li><p>Set the <span>current document readiness</span> of <var
+     title="">document</var> to "complete".</p></li>
+
+     <li><p>Replace all the children of <var title="">document</var>
+     by the children of <var title="">result</var> (even if it has no
+     children), firing mutation events as if a
+     <code>DocumentFragment</code> containing the new children had
+     been inserted.</p></li> <!-- as of 2010-07-26, both Firefox and
+     Opera fired mutation events here. -->
+
+     <!-- If the document doesn't have no nodes here, at time of
+     writing, Opera would leave the new nodes and drop the parsed
+     ones, while Firefox would basically abort instead, failing to
+     fire the 'load' event -->
+
+     <li><p><span>Fire a simple event</span> named <code
+     title="event-load">load</code> at <var
+     title="">document</var>.</p></li>
+
+    </ol>
+
+   </li>
+
+   <li><p>If <code title="dom-XMLDocumentLoader-async">async</code> is
+   set to false, return <var title="">success</var>.</p></li>
+
+  </ol>
+
+  </div>
+
+
   <h3>Elements</h3>
 
   <h4>Semantics</h4>
@@ -72134,7 +72256,7 @@
   and <code title="dom-windowtimers-setInterval">setInterval()</code>
   methods allow authors to schedule timer-based callbacks.</p>
 
-<pre class="idl">[Supplemental, NoInterfaceObject]
+  <pre class="idl">[Supplemental, NoInterfaceObject]
 interface <dfn>WindowTimers</dfn> {
   long <span title="dom-windowtimers-setTimeout">setTimeout</span>(in any handler, in optional any timeout, in any... args);
   void <span title="dom-windowtimers-clearTimeout">clearTimeout</span>(in long handle);
@@ -97764,6 +97886,7 @@
 tfoot, tfoot[hidden] { display: table-footer-group; }
 tr, tr[hidden] { display: table-row; }
 td, th, td[hidden], th[hidden] { display: table-cell; }
+
 colgroup[hidden], col[hidden], thead[hidden], tbody[hidden],
 tfoot[hidden], tr[hidden], td[hidden], th[hidden] {
   visibility: collapse;




More information about the Commit-Watchers mailing list