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

html5/spec Overview.html,1.1224,1.1225

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 11 Aug 2008 05:05:23 +0000
To: public-html-commits@w3.org
Message-Id: <E1KSPat-00053o-N6@lionel-hutz.w3.org>

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

Modified Files:
	Overview.html 
Log Message:
Define insertAdjacentHTML(). (whatwg r2040)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1224
retrieving revision 1.1225
diff -u -d -r1.1224 -r1.1225
--- Overview.html	11 Aug 2008 00:25:48 -0000	1.1224
+++ Overview.html	11 Aug 2008 05:05:20 -0000	1.1225
@@ -7642,7 +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);
+  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>;
@@ -9131,8 +9131,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) -->
Received on Monday, 11 August 2008 05:19:27 GMT

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