[html5] r2040 - [] (0) Define insertAdjacentHTML().
whatwg at whatwg.org
whatwg at whatwg.org
Sun Aug 10 22:04:47 PDT 2008
Author: ianh
Date: 2008-08-10 22:04:46 -0700 (Sun, 10 Aug 2008)
New Revision: 2040
Modified:
index
source
Log:
[] (0) Define insertAdjacentHTML().
Modified: index
===================================================================
--- index 2008-08-11 00:25:14 UTC (rev 2039)
+++ index 2008-08-11 05:04:46 UTC (rev 2040)
@@ -7634,7 +7634,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);
+ void <a href="#insertadjacenthtml" title=dom-insertAdjacentHTML>insertAdjacentHTML</a>(in DOMString position, in DOMString text);
// <span>metadata attributes</span>
attribute DOMString <a href="#id0" title=dom-id>id</a>;
@@ -9123,8 +9123,108 @@
<hr>
- <p class=big-issue><dfn id=insertadjacenthtml0
- title=dom-insertAdjacentHTML-HTML><code>insertAdjacentHTML()</code></dfn></p>
+ <p>The <dfn id=insertadjacenthtml0
+ title=dom-insertAdjacentHTML-HTML><code>insertAdjacentHTML(<var
+ title="">position</var>, <var title="">text</var>)</code></dfn> method,
+ when invoked, must run the following steps:
+
+ <ol>
+ <li>
+ <p>Let <var title="">position</var> and <var title="">text</var> be the
+ method's first and second arguments, respectively.</p>
+
+ <li>
+ <p>Let <var title="">target</var> be the element on which the method was
+ invoked.</p>
+
+ <li>
+ <p>Use the first matching item from this list:</p>
+
+ <dl>
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "beforebegin"
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "afterend"
+
+ <dd>
+ <p>If <var title="">target</var> has no parent node, then abort these
+ steps.</p>
+
+ <p>If <var title="">target</var>'s parent node is a
+ <code>Document</code> object, then throw a
+ <code>NO_MODIFICATION_ALLOWED_ERR</code> exception and abort these
+ steps.
+
+ <p>Otherwise, let <var title="">context</var> be the parent node of
+ <var title="">target</var>.</p>
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "afterbegin"
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "beforeend"
+
+ <dd>
+ <p>Let <var title="">context</var> be the same as <var
+ title="">target</var>.</p>
+
+ <dt>Otherwise
+
+ <dd>
+ <p>Throw a <code>SYNTAX_ERR</code> exception.</p>
+ </dl>
+
+ <li>
+ <p>Invoke the <a href="#html-fragment0">HTML fragment parsing
+ algorithm</a>, with the <var title="">context</var> element being that
+ selected by the previous step, and <var title="">input</var> being the
+ method's <var title="">text</var> argument. Let <var title="">new
+ children</var> be the result of this algorithm.</p>
+
+ <li>
+ <p>Let <var title="">target document</var> be the <code
+ title="">ownerDocument</code> of <var title="">target</var>.</p>
+
+ <li>
+ <p>Set the <code title="">ownerDocument</code> of all the nodes in <var
+ title="">new children</var> to the <var title="">target document</var>.</p>
+
+ <li>
+ <p>Use the first matching item from this list:</p>
+
+ <dl>
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "beforebegin"
+
+ <dd>
+ <p>Insert all the <var title="">new children</var> nodes immediately
+ before <var title="">target</var>, preserving their order.</p>
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "afterbegin"
+
+ <dd>
+ <p>Insert all the <var title="">new children</var> nodes before the
+ first child of <var title="">target</var>, if there is one, preserving
+ their order. If there is no such child, append them all to <var
+ title="">target</var>, preserving their order.</p>
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "beforeend"
+
+ <dd>
+ <p>Append all the <var title="">new children</var> nodes to <var
+ title="">target</var>, preserving their order.</p>
+
+ <dt>If <var title="">position</var> is an <a href="#ascii">ASCII
+ case-insensitive</a> match for the string "afterend"
+
+ <dd>
+ <p>Insert all the <var title="">new children</var> nodes immediately
+ after <var title="">target</var>, preserving their order.</p>
+ </dl>
+ </ol>
<!-- 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) -->
Modified: source
===================================================================
--- source 2008-08-11 00:25:14 UTC (rev 2039)
+++ source 2008-08-11 05:04:46 UTC (rev 2040)
@@ -5547,7 +5547,7 @@
// <span>dynamic markup insertion</span>
attribute DOMString <span title="dom-innerHTML">innerHTML</span>;
attribute DOMString <span title="dom-outerHTML">outerHTML</span>;
- void <span title="dom-insertAdjacentHTML">insertAdjacentHTML</span>(in DOMString position, in DOMString data);
+ void <span title="dom-insertAdjacentHTML">insertAdjacentHTML</span>(in DOMString position, in DOMString text);
// <span>metadata attributes</span>
attribute DOMString <span title="dom-id">id</span>;
@@ -7082,9 +7082,159 @@
<hr>
- <p class="big-issue"><dfn title="dom-insertAdjacentHTML-HTML"><code>insertAdjacentHTML()</code></dfn></p>
+ <p>The <dfn
+ title="dom-insertAdjacentHTML-HTML"><code>insertAdjacentHTML(<var
+ title="">position</var>, <var title="">text</var>)</code></dfn>
+ method, when invoked, must run the following steps:</p>
+ <ol>
+ <li>
+
+ <p>Let <var title="">position</var> and <var title="">text</var>
+ be the method's first and second arguments, respectively.</p>
+
+ </li>
+
+ <li>
+
+ <p>Let <var title="">target</var> be the element on which the
+ method was invoked.</p>
+
+ </li>
+
+ <li>
+
+ <p>Use the first matching item from this list:</p>
+
+ <dl>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "beforebegin"</dt>
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "afterend"</dt>
+
+ <dd>
+
+ <p>If <var title="">target</var> has no parent node, then abort
+ these steps.</p>
+
+ <p>If <var title="">target</var>'s parent node is a
+ <code>Document</code> object, then throw a
+ <code>NO_MODIFICATION_ALLOWED_ERR</code> exception and abort
+ these steps.
+
+ <p>Otherwise, let <var title="">context</var> be the parent node
+ of <var title="">target</var>.</p>
+
+ </dd>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "afterbegin"</dt>
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "beforeend"</dt>
+
+ <dd>
+
+ <p>Let <var title="">context</var> be the same as <var
+ title="">target</var>.</p>
+
+ </dd>
+
+ <dt>Otherwise</dt>
+
+ <dd>
+
+ <p>Throw a <code>SYNTAX_ERR</code> exception.</p>
+
+ </dd>
+
+ </dl>
+
+ </li>
+
+ <li>
+
+ <p>Invoke the <span>HTML fragment parsing algorithm</span>, with
+ the <var title="">context</var> element being that selected by the
+ previous step, and <var title="">input</var> being the method's
+ <var title="">text</var> argument. Let <var title="">new
+ children</var> be the result of this algorithm.</p>
+
+ </li>
+
+ <li>
+
+ <p>Let <var title="">target document</var> be the <code
+ title="">ownerDocument</code> of <var title="">target</var>.</p>
+
+ </li>
+
+ <li>
+
+ <p>Set the <code title="">ownerDocument</code> of all the nodes in
+ <var title="">new children</var> to the <var title="">target
+ document</var>.</p>
+
+ </li>
+
+ <li>
+
+ <p>Use the first matching item from this list:</p>
+
+ <dl>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "beforebegin"</dt>
+
+ <dd>
+
+ <p>Insert all the <var title="">new children</var> nodes
+ immediately before <var title="">target</var>, preserving their
+ order.</p>
+
+ </dd>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "afterbegin"</dt>
+
+ <dd>
+
+ <p>Insert all the <var title="">new children</var> nodes before
+ the first child of <var title="">target</var>, if there is one,
+ preserving their order. If there is no such child, append them
+ all to <var title="">target</var>, preserving their order.</p>
+
+ </dd>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "beforeend"</dt>
+
+ <dd>
+
+ <p>Append all the <var title="">new children</var> nodes to <var
+ title="">target</var>, preserving their order.</p>
+
+ </dd>
+
+ <dt>If <var title="">position</var> is an <span>ASCII
+ case-insensitive</span> match for the string "afterend"</dt>
+
+ <dd>
+
+ <p>Insert all the <var title="">new children</var> nodes
+ immediately after <var title="">target</var>, preserving their
+ order.</p>
+
+ </dd>
+
+ </dl>
+
+ </li>
+
+ </ol>
+
+
<!-- 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) -->
More information about the Commit-Watchers
mailing list