W3C home > Mailing lists > Public > public-html-commits@w3.org > May 2009

html5/spec Overview.html,1.2309,1.2310

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Sun, 31 May 2009 08:45:31 +0000
To: public-html-commits@w3.org
Message-Id: <E1MAgfk-0004p3-Kk@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv18506

Modified Files:
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>
    <!--<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>
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -245,7 +245,7 @@
   <!--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.
   </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"> </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>
     <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>
+   <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
+  <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"> </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>;
   <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 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 31 May 2009 08:45:49 GMT