- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sun, 31 May 2009 08:45:31 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv18506 Modified Files: Overview.html Log Message: document.all (bug 6766) (whatwg r3155) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.2309 retrieving revision 1.2310 diff -u -d -r1.2309 -r1.2310 --- Overview.html 30 May 2009 22:41:15 -0000 1.2309 +++ Overview.html 31 May 2009 08:45:28 -0000 1.2310 @@ -152,7 +152,7 @@ <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2> <!--ZZZ:--> <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>--> - <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 30 May 2009</h2> + <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 31 May 2009</h2> <!--:ZZZ--> <dl><!-- ZZZ: update the month/day (twice), (un)comment out <dt>This Version:</dt> @@ -245,7 +245,7 @@ track. <!--ZZZ:--> <!--This specification is the 23 April 2009 Working Draft.--> - This specification is the 30 May 2009 Editor's Draft. + This specification is the 31 May 2009 Editor's Draft. <!--:ZZZ--> </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href="http://www.whatwg.org/">WHATWG</a>. The two specifications are identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of) @@ -5623,11 +5623,12 @@ object every time it is retrieved.</p> </div><h5 id="htmlcollection"><span class="secno">2.9.2.1 </span>HTMLCollection</h5><p>The <code><a href="#htmlcollection-0">HTMLCollection</a></code> interface represents a generic - <a href="#collections-0" title="collections">collection</a> of elements.<pre class="idl">[Callable=<a href="#dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem">namedItem</a>] + <a href="#collections-0" title="collections">collection</a> of elements.</p><!-- XXX IE does [Callable] with magic that calls item() or namedItem() as appropriate as if it were a regular [[Get]] --><pre class="idl">[Callable=<a href="#dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem">namedItem</a>] interface <dfn id="htmlcollection-0">HTMLCollection</dfn> { readonly attribute unsigned long <a href="#dom-htmlcollection-length" title="dom-HTMLCollection-length">length</a>; [IndexGetter] Element <a href="#dom-htmlcollection-item" title="dom-HTMLCollection-item">item</a>(in unsigned long index); [NameGetter] Element <a href="#dom-htmlcollection-nameditem" title="dom-HTMLCollection-namedItem">namedItem</a>(in DOMString name); + <a href="#htmlcollection-0">HTMLCollection</a> <a href="#dom-htmlcollection-tags" title="dom-HTMLCollection-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> <dd> <p>Returns the number of elements in the collection.</p> @@ -5654,6 +5655,11 @@ this method; their name is given by the value of their <code title="">name</code> attribute.</p> </dd> + <dt><var title="">collection</var> = <var title="">collection</var> . <code title="dom-HTMLCollection-tags"><a href="#dom-htmlcollection-tags">tags</a></code>(<var title="">tagName</var>)</dt> + <dd> + <p>Returns a collection that is a filtered view of the current collection, containing only elements with the given tag name.</p> + </dd> + </dl><div class="impl"> <hr><p>The object's <span>indices of the supported indexed @@ -5693,6 +5699,14 @@ </ul><p>If no such elements are found, then the method must return null.</p> + <p>The <dfn id="dom-htmlcollection-tags" title="dom-HTMLCollection-tags"><code>tags(<var title="">tagName</var>)</code></dfn> method must return an + <code><a href="#htmlcollection-0">HTMLCollection</a></code> rooted at the same node as the + <code><a href="#htmlcollection-0">HTMLCollection</a></code> object on which the method was invoked, + whose filter matches only <a href="#html-elements">HTML elements</a> whose local + name is the <var title="">tagName</var> argument. In <a href="#html-documents">HTML + documents</a>, the argument must first be <a href="#converted-to-lowercase">converted to + lowercase</a>.</p> + </div><h5 id="htmlformcontrolscollection"><span class="secno">2.9.2.2 </span>HTMLFormControlsCollection</h5><p>The <code><a href="#htmlformcontrolscollection-0">HTMLFormControlsCollection</a></code> interface represents a <a href="#collections-0" title="collections">collection</a> of <a href="#category-listed" title="category-listed">listed</a> elements in <code><a href="#the-form-element">form</a></code> and <code><a href="#the-fieldset-element">fieldset</a></code> elements.<pre class="idl">[Callable=<a href="#dom-htmlformcontrolscollection-nameditem" title="dom-HTMLFormControlsCollection-namedItem">namedItem</a>] @@ -64240,6 +64254,8 @@ attribute DOMString <a href="#dom-document-linkcolor" title="dom-document-linkColor">linkColor</a>; attribute DOMString <a href="#dom-document-vlinkcolor" title="dom-document-vlinkColor">vlinkColor</a>; attribute DOMString <a href="#dom-document-alinkcolor" title="dom-document-alinkColor">alinkColor</a>; + + readonly attribute <a href="#htmlcollection-0">HTMLCollection</a> <a href="#dom-document-all" title="dom-document-all">all</a>; };</pre> <p>The <dfn id="dom-document-fgcolor" title="dom-document-fgColor"><code>fgColor</code></dfn> @@ -64271,6 +64287,19 @@ element">body element</a>, the attributes must instead return the empty string on getting and do nothing on setting.</p> + <hr><p>The <dfn id="dom-document-all" title="dom-document-all"><code>all</code></dfn> + attribute must return an <code><a href="#htmlcollection-0">HTMLCollection</a></code> rooted at the + <code>Document</code> node, whose filter matches all elements.</p> + + <p>The user agent must act as if the ToBoolean() operator in + JavaScript converted the object returned for <code title="dom-document-all"><a href="#dom-document-all">all</a></code> to the false value.</p> + + <p class="note">This is a <a href="#willful-violation">willful violation</a> of the + JavaScript specification current at the time of writing (ECMAScript + edition 3). The JavaScript specification requires that the + ToBoolean() operator convert all objects to the true value. This + violation is motivated by a desire for compatibility with legacy + content. <a href="#references">[ECMA262]</a></p> <h3 id="conformance-checkers-0"><span class="secno">12.4 </span>Conformance checkers</h3>
Received on Sunday, 31 May 2009 08:45:47 UTC