- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 11 Aug 2008 00:25:50 +0000
- To: public-html-commits@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 UTC