- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 27 Jul 2011 23:10:47 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv16944
Modified Files:
Overview.html
Log Message:
Move some of the quirky API requirements to DOM Core. (whatwg r6333)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5060
retrieving revision 1.5061
diff -u -d -r1.5060 -r1.5061
--- Overview.html 27 Jul 2011 23:07:36 -0000 1.5060
+++ Overview.html 27 Jul 2011 23:10:43 -0000 1.5061
@@ -615,17 +615,16 @@
<li><a href="#requirements-relating-to-bidirectional-algorithm-formatting-characters"><span class="secno">3.2.6 </span>Requirements relating to bidirectional-algorithm formatting
characters</a></li>
<li><a href="#wai-aria"><span class="secno">3.2.7 </span>WAI-ARIA</a></ol></li>
- <li><a href="#apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</a></li>
- <li><a href="#interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</a></li>
- <li><a href="#dynamic-markup-insertion"><span class="secno">3.5 </span>Dynamic markup insertion</a>
+ <li><a href="#interactions-with-xpath-and-xslt"><span class="secno">3.3 </span>Interactions with XPath and XSLT</a></li>
+ <li><a href="#dynamic-markup-insertion"><span class="secno">3.4 </span>Dynamic markup insertion</a>
<ol>
- <li><a href="#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li>
- <li><a href="#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li>
- <li><a href="#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li>
- <li><a href="#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
- <li><a href="#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
- <li><a href="#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
- <li><a href="#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
+ <li><a href="#opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</a></li>
+ <li><a href="#closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</a></li>
+ <li><a href="#document.write"><span class="secno">3.4.3 </span><code title="dom-document-write">document.write()</code></a></li>
+ <li><a href="#document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
+ <li><a href="#innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
+ <li><a href="#outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
+ <li><a href="#insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
<li><a href="#semantics"><span class="secno">4 </span>The elements of HTML</a>
<ol>
<li><a href="#the-root-element"><span class="secno">4.1 </span>The root element</a>
@@ -9979,117 +9978,9 @@
- </div><h3 id="apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</h3><p>For <a href="#html-documents">HTML documents</a>, and for <a href="#html-elements">HTML
- elements</a> in <a href="#html-documents">HTML documents</a>, certain APIs defined
- in DOM Core become case-insensitive or case-changing, as sometimes
- defined in DOM Core, and as summarized <span class="impl">or
- required</span> below. <a href="#refsDOMCORE">[DOMCORE]</a><p>This does not apply to <a href="#xml-documents">XML documents</a> or to elements
- that are not in the <a href="#html-namespace-0">HTML namespace</a> despite being in
- <a href="#html-documents">HTML documents</a>.<dl><dt><code title="dom-Element-tagName"><a href="#dom-element-tagname">Element.tagName</a></code> and <code title="dom-Node-nodeName">Node.nodeName</code></dt>
-
- <dd>
-
- <p>These attributes <span class="impl">must</span> return element
- names <a href="#converted-to-ascii-uppercase">converted to ASCII uppercase</a>, regardless of the case
- with which they were created.</p>
-
- </dd>
-
-
- <dt><code title="dom-Document-createElement"><a href="#dom-document-createelement">Document.createElement()</a></code></dt>
-
- <dd>
-
- <p>The canonical form of HTML markup is all-lowercase; thus, this
- method will <a href="#converted-to-ascii-lowercase" title="converted to ASCII lowercase">lowercase</a>
- the argument before creating the requisite element. <span class="impl">Also, the element created must be in the <a href="#html-namespace-0">HTML
- namespace</a></span>.</p>
-
- <p class="note">This doesn't apply to <code title="dom-Document-createElementNS"><a href="#dom-document-createelementns">Document.createElementNS()</a></code>.
- Thus, it is possible, by passing this last method a tag name in
- the wrong case, to create an element that appears to have the same
- tag name as that of an element defined in this specification when
- its <code title="dom-Element-tagName"><a href="#dom-element-tagname">tagName</a></code> attribute is
- examined, but that doesn't support the corresponding interfaces.
- The "real" element name (unaffected by case conversions) can be
- obtained from the <code title="dom-Node-localName"><a href="#dom-node-localname">localName</a></code> attribute.</p>
-
- </dd>
-
-
- <dt><code title="dom-Element-setAttribute">Element.setAttribute()</code></dt>
- <dt><code title="dom-Element-setAttributeNode">Element.setAttributeNode()</code></dt>
-
- <dd>
-
- <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
- <div class="impl">
-
- <p>Specifically: when an attribute is set on an <a href="#html-elements" title="HTML
- elements">HTML element</a> using <code title="">Element.setAttribute()</code>, the name argument must be
- <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the element is
- affected; and when an <code><a href="#attr">Attr</a></code> node is set on an <a href="#html-elements" title="HTML elements">HTML element</a> using <code title="">Element.setAttributeNode()</code>, it must have its name
- <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the element is
- affected.</p>
-
- </div>
-
- <p class="note">This doesn't apply to <code title="">Element.setAttributeNS()</code> and <code title="">Element.setAttributeNodeNS()</code>.</p>
-
- </dd>
-
-
- <dt><code title="dom-Element-getAttribute">Element.getAttribute()</code></dt>
- <dt><code title="dom-Element-getAttributeNode">Element.getAttributeNode()</code></dt>
-
- <dd>
-
- <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
- <div class="impl">
-
- <p>Specifically: When the <code title="">Element.getAttribute()</code> method or the <code title="">Element.getAttributeNode()</code> method is invoked on
- an <a href="#html-elements" title="HTML elements">HTML element</a>, the name
- argument must be <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the
- element's attributes are examined.</p>
-
- </div>
-
- <p class="note">This doesn't apply to <code title="">Element.getAttributeNS()</code> and <code title="">Element.getAttributeNodeNS()</code>.</p>
-
- </dd>
-
-
- <dt><code title="dom-Document-getElementsByTagName">Document.getElementsByTagName()</code></dt>
- <dt><code title="dom-Element-getElementsByTagName">Element.getElementsByTagName()</code></dt>
-
- <dd>
-
- <p>HTML elements match by lower-casing the argument before
- comparison, elements from other namespaces are treated as in XML
- (case-sensitively).</p>
-
- <div class="impl">
-
- <p>Specifically, these methods (but not their namespaced
- counterparts) must compare the given argument in a
- <a href="#case-sensitive">case-sensitive</a> manner, but when looking at <a href="#html-elements" title="HTML elements">HTML elements</a>, the argument must
- first be <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
- </div>
-
- <p class="note">Thus, in an <a href="#html-documents" title="HTML documents">HTML
- document</a> with nodes in multiple namespaces, these methods
- will effectively be both case-sensitive and case-insensitive at
- the same time.</p>
-
- </dd>
-
-
- </dl><div class="impl">
+ </div><div class="impl">
- <h3 id="interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</h3>
+ <h3 id="interactions-with-xpath-and-xslt"><span class="secno">3.3 </span>Interactions with XPath and XSLT</h3>
<p id="xpath-1.0-processors">Implementations of XPath 1.0 that
operate on <a href="#html-documents">HTML documents</a> parsed or created in the
@@ -10176,11 +10067,11 @@
interaction of XSLT and HTML <a href="#scriptTagXSLT">in the
<code>script</code> element section</a>.</p>
- </div><h3 id="dynamic-markup-insertion"><span class="secno">3.5 </span><dfn>Dynamic markup insertion</dfn></h3><p class="note">APIs for dynamically inserting markup into the
+ </div><h3 id="dynamic-markup-insertion"><span class="secno">3.4 </span><dfn>Dynamic markup insertion</dfn></h3><p class="note">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-documents">HTML documents</a>
(and the <a href="#html-parser">HTML parser</a>) or XHTML in <a href="#xml-documents">XML
- documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
+ documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
method comes in several variants with different numbers of
arguments.<dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( [ <var title="">type</var> [, <var title="">replace</var> ] ] )</dt>
@@ -10379,7 +10270,7 @@
<code><a href="#window">Window</a></code> object, then the method must raise an
<code><a href="#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception.</p>
- </div><h4 id="closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
+ </div><h4 id="closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
<dd>
@@ -10415,7 +10306,7 @@
"EOF" character</a> or <a href="#spin-the-event-loop" title="spin the event loop">spins
the event loop</a>.</li>
- </ol></div><h4 id="document.write"><span class="secno">3.5.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
+ </ol></div><h4 id="document.write"><span class="secno">3.4.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -10520,7 +10411,7 @@
</li>
- </ol></div><h4 id="document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
+ </ol></div><h4 id="document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
<dd>
@@ -10541,7 +10432,7 @@
invoked with the same argument(s), plus an extra argument consisting
of a string containing a single line feed character (U+000A).</p>
- </div><h4 id="innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> IDL
+ </div><h4 id="innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> IDL
attribute represents the markup of the node's contents.<dl class="domintro"><dt><var title="">document</var> . <code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -10652,7 +10543,7 @@
</li>
- </ol></div><h4 id="outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> IDL
+ </ol></div><h4 id="outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> IDL
attribute represents the markup of the element and its contents.<dl class="domintro"><dt><var title="">element</var> . <code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -10758,7 +10649,7 @@
</li>
- </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
+ </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
<dd>
Received on Wednesday, 27 July 2011 23:10:53 UTC