W3C home > Mailing lists > Public > public-html-commits@w3.org > August 2008

html5/spec Overview.html,1.1223,1.1224

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 11 Aug 2008 00:25:50 +0000
To: public-html-commits@w3.org
Message-Id: <E1KSLEN-00014T-0a@lionel-hutz.w3.org>

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv3765

Modified Files:
	Overview.html 
Log Message:
Prepare the ground for insertAdjacentHTML(). (whatwg r2039)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1223
retrieving revision 1.1224
diff -u -d -r1.1223 -r1.1224
--- Overview.html	11 Aug 2008 00:07:12 -0000	1.1223
+++ Overview.html	11 Aug 2008 00:25:48 -0000	1.1224
@@ -27,7 +27,7 @@
     for HTML and XHTML</h2>
 
    <h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" -->
-    Editor's Draft <!--ZZZ-->10 August 2008</h2>
+    Editor's Draft <!--ZZZ-->11 August 2008</h2>
 
    <dl><!-- ZZZ: update the month/day
     <dt>This Version:</dt>
@@ -199,7 +199,7 @@
 
   <p>The W3C <a href="http://www.w3.org/html/wg/">HTML Working Group</a> is
    the W3C working group responsible for this specification's progress along
-   the W3C Recommendation track. <!--ZZZ:--> This specification is the 10
+   the W3C Recommendation track. <!--ZZZ:--> This specification is the 11
    August 2008 <!--ZZZ "Working Draft"-->Editor's Draft. <!--:ZZZ--></p>
   <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST -->
   <!-- relationship to other work (required) -->
@@ -7642,6 +7642,7 @@
   // <a href="#dynamic3">dynamic markup insertion</a>
            attribute DOMString <a href="#innerhtml" title=dom-innerHTML>innerHTML</a>;
            attribute DOMString <a href="#outerhtml" title=dom-outerHTML>outerHTML</a>;
+  void <a href="#insertadjacenthtml" title=dom-insertAdjacentHTML>insertAdjacentHTML</a>(in DOMString position, in DOMString data);
 
   // <span>metadata attributes</span>
            attribute DOMString <a href="#id0" title=dom-id>id</a>;
@@ -8708,18 +8709,12 @@
   <h3 id=dynamic0><span class=secno>3.7 </span><dfn id=dynamic3>Dynamic
    markup insertion</dfn></h3>
 
-  <p>The <code title=dom-document-write><a
-   href="#document.write">document.write()</a></code> family of methods and
-   the <code title=dom-innerHTML><a
-   href="#innerhtml">innerHTML</a></code>/<code title=dom-outerHTML><a
-   href="#outerhtml">outerHTML</a></code> family of DOM attributes enable
-   script authors to dynamically insert markup into the document.
-
-  <p>Because these APIs interact with the parser, their behavior varies
-   depending on whether they are used with <a href="#html-">HTML
-   documents</a> (and the <a href="#html-0">HTML parser</a>) or XHTML in <a
-   href="#xml-documents">XML documents</a> (and the <span>XML parser</span>).
-   The following table cross-references the various versions of these APIs.
+  <p>APIs for dynamically inserting markup into the document interact with
+   the parser, and thus their behavior varies depending on whether they are
+   used with <a href="#html-">HTML documents</a> (and the <a
+   href="#html-0">HTML parser</a>) or XHTML in <a href="#xml-documents">XML
+   documents</a> (and the <span>XML parser</span>). The following table
+   cross-references the various versions of these APIs.
 
   <table>
    <thead>
@@ -8763,6 +8758,17 @@
       title=dom-outerHTML-HTML><code>outerHTML</code> in HTML</a>
 
      <td><a href="#outerhtml1" title=dom-outerHTML-XML>not supported</a>
+
+    <tr>
+     <th><dfn id=insertadjacenthtml
+      title=dom-insertAdjacentHTML><code>insertAdjacentHTML()</code></dfn>
+
+     <td><a href="#insertadjacenthtml0"
+      title=dom-insertAdjacentHTML-HTML><code>insertAdjacentHTML()</code> in
+      HTML</a>
+
+     <td><a href="#insertadjacenthtml1" title=dom-insertAdjacentHTML-XML>not
+      supported</a>
   </table>
 
   <p>Regardless of the parsing mode, the <dfn id=document.writeln...
@@ -8775,8 +8781,10 @@
   <p class=note>The <code title=dom-innerHTML><a
    href="#innerhtml">innerHTML</a></code> attribute applies to both
    <code>Element</code> nodes as well as <code>Document</code> nodes. The
-   <code title=dom-outerHTML><a href="#outerhtml">outerHTML</a></code>
-   attribute, on the other hand, only applies to <code>Element</code> nodes.
+   <code title=dom-outerHTML><a href="#outerhtml">outerHTML</a></code> and
+   <code title=dom-insertAdjacentHTML><a
+   href="#insertadjacenthtml">insertAdjacentHTML</a></code> attributes, on
+   the other hand, only apply to <code>Element</code> nodes.
 
   <p class=note>When inserted using the <code title=dom-document-write><a
    href="#document.write">document.write()</a></code> method, <code><a
@@ -9120,7 +9128,12 @@
      its place all the <var title="">new children</var> nodes, preserving
      their order.</p>
   </ol>
-  <!-- XXX must make sure we spec that innerHTML causes mutation
+
+  <hr>
+
+  <p class=big-issue><dfn id=insertadjacenthtml0
+   title=dom-insertAdjacentHTML-HTML><code>insertAdjacentHTML()</code></dfn></p>
+  <!-- XXX must make sure we spec that innerHTML et al causes mutation
   events to fire, but document.write() doesn't. (the latter is already
   req-stated in the parser section, btw) -->
   <!-- http://msdn.microsoft.com/workshop/author/dhtml/reference/properties/innerhtml.asp -->
@@ -9265,8 +9278,10 @@
   <hr>
 
   <p>In an XML context, the <dfn id=document.write0
-   title=dom-document-write-XML><code>document.write()</code></dfn> method,
-   and the <dfn id=outerhtml1
+   title=dom-document-write-XML><code>document.write()</code></dfn> and <dfn
+   id=insertadjacenthtml1
+   title=dom-insertAdjacentHTML-XML><code>insertAdjacentHTML()</code></dfn>
+   methods, and the <dfn id=outerhtml1
    title=dom-outerHTML-XML><code>outerHTML</code></dfn> attribute on both
    getting and setting, must raise an <code>INVALID_ACCESS_ERR</code>
    exception.</p>
@@ -26210,8 +26225,8 @@
      parser</span> that itself was created as part of the processing of the
      <code title=dom-innerHTML-XML><a href="#innerhtml1">innerHTML</a></code>
      attribute's setter<!--
-    no need to worry about the innerHTML-HTML case, as the HTML parser
-    handles that for us, and outerHTML-XML doesn't work-->,
+    no need to worry about the HTML case, as the HTML parser handles
+    that for us -->,
      or if the user agent does not <a href="#support">support the scripting
      language</a> given by <var><a href="#the-scripts">the script's
      type</a></var> for this <code><a href="#script1">script</a></code>
@@ -45949,9 +45964,10 @@
    something other than a <link> or a <style> element; you'd expect
    that to break out of the <noscript> but it doesn't. This is an edge
    case that doesn't affect the spec, since the algorithm for fragment
-   parsing is only used for innerHTML/outerHTML, where we know
-   scripting is enabled. (XXX except maybe if innerHTML is set from
-   another browsing context on a document with designMode set?) -->
+   parsing is only used for innerHTML/outerHTML/insertAdjacentHTML(),
+   where we know scripting is enabled. (XXX except maybe if innerHTML
+   is set from another browsing context on a document with designMode
+   set?) -->
 
    <li>If <var title="">node</var> is a <code><a
     href="#body0">body</a></code> element, then switch the <span>insertion
@@ -48133,11 +48149,8 @@
    content inserted using <code title=dom-document-write-HTML><a
    href="#document.write...">document.write()</a></code> and <code
    title=dom-document-writeln><a
-   href="#document.writeln...">document.writeln()</a></code> calls.<!--
-  XXX xref -->
-   <a href="#references">[DOM3EVENTS]</a></p>
-  <!-- XXX
-  what about innerHTML? -->
+   href="#document.writeln...">document.writeln()</a></code> calls. <a
+   href="#references">[DOM3EVENTS]</a>
 
   <p class=note>Not all of the tag names mentioned below are conformant tag
    names in this specification; many are included to handle legacy content.
@@ -49101,10 +49114,12 @@
      element as "already executed" prevents it from executing when it is
      inserted into the document a few paragraphs below. Thus, scripts missing
      their end tags and scripts that were inserted using <code
-     title=dom-innerHTML-HTML><a
-     href="#innerhtml0">innerHTML</a></code>/<code
-     title=dom-outerHTML-HTML><a href="#outerhtml0">outerHTML</a></code>
-     aren't executed.</p>
+     title=dom-innerHTML-HTML><a href="#innerhtml0">innerHTML</a></code>,
+     <code title=dom-outerHTML-HTML><a
+     href="#outerhtml0">outerHTML</a></code>, or <code
+     title=dom-insertAdjacentHTML-HTML><a
+     href="#insertadjacenthtml0">insertAdjacentHTML()</a></code> aren't
+     executed.</p>
 
     <p>Let the <var title="">old insertion point</var> have the same value as
      the current <a href="#insertion">insertion point</a>. Let the <a
@@ -51502,9 +51517,7 @@
      href="#html-fragment0">HTML fragment parsing algorithm</a>, this is a <a
      href="#parse2">parse error</a>; ignore the token. (<a
      href="#fragment">fragment case</a>)</p>
-    <!-- can only happen for <html>'s own innerHTML or its children's
-    outerHTML -->
-    
+
     <p>Otherwise, switch the <span>insertion mode</span> to "<a
      href="#after12" title="insertion mode: after after body">after after
      body</a>".</p>
Received on Monday, 11 August 2008 00:26:26 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 9 October 2008 20:32:58 GMT