- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 26 Jul 2011 23:32:44 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv14467 Modified Files: Overview.html Log Message: Move HTMLCollection to DOM Core (whatwg r6327) Index: Overview.html =================================================================== 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:32:50 UTC