- From: poot <cvsmail@w3.org>
- Date: Tue, 26 Jul 2011 19:33:10 -0400
- To: public-html-diffs@w3.org
hixie: Move HTMLCollection to DOM Core (whatwg r6327)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5055&r2=1.5056&f=h
http://html5.org/tools/web-apps-tracker?from=6326&to=6327
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5055
retrieving revision 1.5056
diff -u -d -r1.5055 -r1.5056
--- Overview.html 26 Jul 2011 17:42:33 -0000 1.5055
+++ Overview.html 26 Jul 2011 23:32:40 -0000 1.5056
@@ -563,10 +563,9 @@
<li><a href="#reflecting-content-attributes-in-idl-attributes"><span class="secno">2.8.1 </span>Reflecting content attributes in IDL attributes</a></li>
<li><a href="#collections-0"><span class="secno">2.8.2 </span>Collections</a>
<ol>
- <li><a href="#htmlcollection-0"><span class="secno">2.8.2.1 </span>HTMLCollection</a></li>
- <li><a href="#htmlallcollection-0"><span class="secno">2.8.2.2 </span>HTMLAllCollection</a></li>
- <li><a href="#htmlformcontrolscollection-0"><span class="secno">2.8.2.3 </span>HTMLFormControlsCollection</a></li>
- <li><a href="#htmloptionscollection-0"><span class="secno">2.8.2.4 </span>HTMLOptionsCollection</a></ol></li>
+ <li><a href="#htmlallcollection-0"><span class="secno">2.8.2.1 </span>HTMLAllCollection</a></li>
+ <li><a href="#htmlformcontrolscollection-0"><span class="secno">2.8.2.2 </span>HTMLFormControlsCollection</a></li>
+ <li><a href="#htmloptionscollection-0"><span class="secno">2.8.2.3 </span>HTMLOptionsCollection</a></ol></li>
<li><a href="#domtokenlist-0"><span class="secno">2.8.3 </span>DOMTokenList</a></li>
<li><a href="#domsettabletokenlist-0"><span class="secno">2.8.4 </span>DOMSettableTokenList</a></li>
<li><a href="#domstringmap-0"><span class="secno">2.8.5 </span>DOMStringMap</a></li>
@@ -2890,6 +2889,8 @@
<li><dfn id="processinginstruction"><code>ProcessingInstruction</code></dfn> interface</li>
<li><dfn id="text"><code>Text</code></dfn> interface</li>
+ <li><dfn id="htmlcollection"><code>HTMLCollection</code></dfn> interface, and the terms <dfn id="collections">collections</dfn> and <dfn id="represented-by-the-collection">represented by the collection</dfn></li>
+
<li><dfn id="dom-domimplementation-createdocument" title="dom-DOMImplementation-createDocument"><code>createDocument()</code></dfn> method</li>
<li><dfn id="dom-document-createelement" title="dom-Document-createElement"><code>createElement()</code></dfn> method</li>
<li><dfn id="dom-document-createelementns" title="dom-Document-createElementNS"><code>createElementNS()</code></dfn> method</li>
@@ -6662,113 +6663,24 @@
attribute. Otherwise, the IDL attribute must be set to the empty
string.</p>
- </div><h4 id="collections-0"><span class="secno">2.8.2 </span>Collections</h4><p>The <code><a href="#htmlcollection">HTMLCollection</a></code>, <code><a href="#htmlallcollection">HTMLAllCollection</a></code>,
+ </div><h4 id="collections-0"><span class="secno">2.8.2 </span>Collections</h4><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code>,
<code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code>,
<code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code>,
- interfaces represent various
- lists of DOM nodes. Collectively, objects implementing these
- interfaces are called <dfn id="collections">collections</dfn>.<p>When a <a href="#collections" title="collections">collection</a> is created, a
- filter and a root are associated with the collection.<p class="example">For example, when the <code><a href="#htmlcollection">HTMLCollection</a></code>
- object for the <code title="dom-document-images"><a href="#dom-document-images">document.images</a></code> attribute is
- created, it is associated with a filter that selects only
- <code><a href="#the-img-element">img</a></code> elements, and rooted at the root of the
- document.<p>The <a href="#collections" title="collections">collection</a> then <dfn id="represented-by-the-collection" title="represented by the collection">represents</dfn> a
- <a href="#live">live</a> view of the subtree rooted at the collection's
- root, containing only nodes that match the given filter. The view is
- linear. <span class="impl">In the absence of specific requirements
- to the contrary, the nodes within the collection must be sorted in
- <a href="#tree-order">tree order</a>.</span><div class="impl">
-
- <p class="note">The <code title="dom-table-rows"><a href="#dom-table-rows">rows</a></code> list is
- not in tree order.</p>
-
- <p>An attribute that returns a collection must return the same
- object every time it is retrieved.</p>
-
- </div><h5 id="htmlcollection-0"><span class="secno">2.8.2.1 </span>HTMLCollection</h5><p>The <code><a href="#htmlcollection">HTMLCollection</a></code> interface represents a generic
- <a href="#collections" title="collections">collection</a> of elements.<pre class="idl">interface <dfn id="htmlcollection">HTMLCollection</dfn> {
- readonly attribute unsigned long <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a>;
- caller getter <a href="#element">Element</a>? <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>(in unsigned long index);
- caller getter object? <a href="#dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem">namedItem</a>(in DOMString name); // only returns Element
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
- <dd>
- <p>Returns the number of elements in the collection.</p>
- </dd>
-
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
- <dt><var title="">collection</var>[<var title="">index</var>]</dt>
- <dt><var title="">collection</var>(<var title="">index</var>)</dt>
- <dd>
- <p>Returns the item with index <var title="">index</var> from the collection. The items are sorted in <a href="#tree-order">tree order</a>.</p>
- </dd>
-
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-namedItem"><a href="#dom-htmlcollection-nameditem">namedItem</a></code>(<var title="">name</var>)</dt>
- <dt><var title="">collection</var>[<var title="">name</var>]</dt>
- <dt><var title="">collection</var>(<var title="">name</var>)</dt>
- <dd>
- <p>Returns the first item with <a href="#concept-id" title="concept-id">ID</a> or name <var title="">name</var>
- from the collection.</p>
- <p>Only <code><a href="#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="#the-area-element">area</a></code>,
- <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-form-element">form</a></code>, <code><a href="#frame">frame</a></code>,
- <code><a href="#frameset">frameset</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, and
- <code><a href="#the-object-element">object</a></code> elements can have a name for the purpose of
- this method; their name is given by the value of their <code title="">name</code> attribute.</p>
- </dd>
- </dl><div class="impl">
-
- <p>The object's <a href="#supported-property-indices">supported property indices</a> are the
- numbers in the range zero to one less than the number of nodes
- <a href="#represented-by-the-collection">represented by the collection</a>. If there are no such
- elements, then there are no <a href="#supported-property-indices">supported property
- indices</a>.</p>
-
- <p>The <dfn id="dom-htmlcollection-length" title="dom-HTMLCollection-length"><code>length</code></dfn>
- attribute must return the number of nodes <a href="#represented-by-the-collection">represented by the
- collection</a>.</p>
-
- <p>The <dfn id="dom-htmlcollection-item" title="dom-HTMLCollection-item"><code>item(<var title="">index</var>)</code></dfn> method must return the <var title="">index</var>th node in the collection. If there is no <var title="">index</var>th node in the collection, then the method must
- return null.</p>
-
- <p>The <a href="#supported-property-names">supported property names</a> consist
- of the values of the <code title="">name</code> attributes of each
- <code><a href="#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>, <code><a href="#the-area-element">area</a></code>,
- <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-form-element">form</a></code>, <code><a href="#frame">frame</a></code>,
- <code><a href="#frameset">frameset</a></code>, <code><a href="#the-iframe-element">iframe</a></code>, <code><a href="#the-img-element">img</a></code>, and
- <code><a href="#the-object-element">object</a></code> element <a href="#represented-by-the-collection">represented by the
- collection</a> with a <code title="">name</code> attribute, plus
- the list of IDs that the elements <a href="#represented-by-the-collection">represented by the
- collection</a> have.</p>
-
- <p>The <dfn id="dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem"><code>namedItem(<var title="">key</var>)</code></dfn> method must return the first node
- in the collection that matches either of the following
- requirements:</p>
-
- <ul><li>It is an <code><a href="#the-a-element">a</a></code>, <code><a href="#the-applet-element">applet</a></code>,
- <code><a href="#the-area-element">area</a></code>, <code><a href="#the-embed-element">embed</a></code>, <code><a href="#the-form-element">form</a></code>,
- <code><a href="#frame">frame</a></code>, <code><a href="#frameset">frameset</a></code>, <code><a href="#the-iframe-element">iframe</a></code>,
- <code><a href="#the-img-element">img</a></code>, or <code><a href="#the-object-element">object</a></code> element with a <code title="">name</code> attribute equal to <var title="">key</var>,
- or,</li>
-
- <li>It is an element with an <a href="#concept-id" title="concept-id">ID</a>
- equal to <var title="">key</var>.</li>
-
- </ul><p>If no such elements are found, then the method must return
- null.</p>
-
- </div><h5 id="htmlallcollection-0"><span class="secno">2.8.2.2 </span>HTMLAllCollection</h5><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code> interface represents a generic
+ interfaces are <a href="#collections">collections</a> derived from the
+ <code><a href="#htmlcollection">HTMLCollection</a></code> interface.<h5 id="htmlallcollection-0"><span class="secno">2.8.2.1 </span>HTMLAllCollection</h5><p>The <code><a href="#htmlallcollection">HTMLAllCollection</a></code> interface represents a generic
<a href="#collections" title="collections">collection</a> of elements just like
<code><a href="#htmlcollection">HTMLCollection</a></code>, with the exception that its <code title="dom-HTMLAllCollection-namedItem"><a href="#dom-htmlallcollection-nameditem">namedItem()</a></code> method
returns an <code><a href="#htmlallcollection">HTMLAllCollection</a></code> object when there are
multiple matching elements.<pre class="idl">interface <dfn id="htmlallcollection">HTMLAllCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a> and <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
+ // inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
caller getter object? <a href="#dom-htmlallcollection-nameditem" title="dom-HTMLAllCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
<a href="#htmlallcollection">HTMLAllCollection</a> <a href="#dom-htmlallcollection-tags" title="dom-HTMLAllCollection-tags">tags</a>(in DOMString tagName);
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
+};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length">length</code></dt>
<dd>
<p>Returns the number of elements in the collection.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
@@ -6842,21 +6754,21 @@
documents</a>, the argument must first be <a href="#converted-to-ascii-lowercase">converted to
ASCII lowercase</a>.</p>
- </div><h5 id="htmlformcontrolscollection-0"><span class="secno">2.8.2.3 </span>HTMLFormControlsCollection</h5><p>The <code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code> interface represents
+ </div><h5 id="htmlformcontrolscollection-0"><span class="secno">2.8.2.2 </span>HTMLFormControlsCollection</h5><p>The <code><a href="#htmlformcontrolscollection">HTMLFormControlsCollection</a></code> interface represents
a <a href="#collections" title="collections">collection</a> of <a href="#category-listed" title="category-listed">listed elements</a> in <code><a href="#the-form-element">form</a></code>
and <code><a href="#the-fieldset-element">fieldset</a></code> elements.<pre class="idl">interface <dfn id="htmlformcontrolscollection">HTMLFormControlsCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a> and <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
+ // inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
caller getter object? <a href="#dom-htmlformcontrolscollection-nameditem" title="dom-HTMLFormControlsCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
};
interface <dfn id="radionodelist">RadioNodeList</dfn> : <a href="#nodelist">NodeList</a> {
attribute DOMString <a href="#dom-radionodelist-value" title="dom-RadioNodeList-value">value</a>;
-};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length"><a href="#dom-htmlcollection-length">length</a></code></dt>
+};</pre><dl class="domintro"><dt><var title="">collection</var> . <code title="dom-HTMLCollection-length">length</code></dt>
<dd>
<p>Returns the number of elements in the collection.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
@@ -6945,11 +6857,11 @@
<li><p>If <var title="">element</var> is not null, then set its
<a href="#concept-fe-checked" title="concept-fe-checked">checkedness</a> to true.</p>
- </ol></div><h5 id="htmloptionscollection-0"><span class="secno">2.8.2.4 </span>HTMLOptionsCollection</h5><p>The <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> interface represents a
+ </ol></div><h5 id="htmloptionscollection-0"><span class="secno">2.8.2.3 </span>HTMLOptionsCollection</h5><p>The <code><a href="#htmloptionscollection">HTMLOptionsCollection</a></code> interface represents a
list of <code><a href="#the-option-element">option</a></code> elements. It is always rooted on a
<code><a href="#the-select-element">select</a></code> element and has attributes and methods that
manipulate that element's descendants.<pre class="idl">interface <dfn id="htmloptionscollection">HTMLOptionsCollection</dfn> : <a href="#htmlcollection">HTMLCollection</a> {
- // inherits <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>()
+ // inherits <span title="dom-HTMLCollection-item">item</span>()
attribute unsigned long <a href="#dom-htmloptionscollection-length" title="dom-HTMLOptionsCollection-length">length</a>; // overrides inherited length
caller getter object? <a href="#dom-htmloptionscollection-nameditem" title="dom-HTMLOptionsCollection-namedItem">namedItem</a>(in DOMString name); // overrides inherited namedItem()
void <a href="#dom-htmloptionscollection-add" title="dom-HTMLOptionsCollection-add">add</a>(in <a href="#htmlelement">HTMLElement</a> element, in optional <a href="#htmlelement">HTMLElement</a>? before);
@@ -6963,7 +6875,7 @@
<p>When set to a greater number, adds new blank <code><a href="#the-option-element">option</a></code> elements to that container.</p>
</dd>
- <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item"><a href="#dom-htmlcollection-item">item</a></code>(<var title="">index</var>)</dt>
+ <dt><var title="">element</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-item">item</code>(<var title="">index</var>)</dt>
<dt><var title="">collection</var>[<var title="">index</var>]</dt>
<dt><var title="">collection</var>(<var title="">index</var>)</dt>
<dd>
Received on Tuesday, 26 July 2011 23:33:17 UTC