W3C home > Mailing lists > Public > public-html-diffs@w3.org > February 2010

hixie: Define whether these methods and attributes return the same object or a different object each time they are called. (whatwg r4702)

From: poot <cvsmail@w3.org>
Date: Sat, 13 Feb 2010 20:26:28 +0900 (JST)
To: public-html-diffs@w3.org
Message-Id: <20100213112629.035EE2BC36@toro.w3.mag.keio.ac.jp>
hixie: Define whether these methods and attributes return the same
object or a different object each time they are called. (whatwg r4702)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3752&r2=1.3753&f=h
http://html5.org/tools/web-apps-tracker?from=4701&to=4702

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3752
retrieving revision 1.3753
diff -u -d -r1.3752 -r1.3753
--- Overview.html	13 Feb 2010 11:03:33 -0000	1.3752
+++ Overview.html	13 Feb 2010 11:26:16 -0000	1.3753
@@ -6395,7 +6395,11 @@
   containing all the <a href="#html-elements">HTML elements</a> in that document that
   have a <code title="">name</code> attribute whose value is equal to
   the <var title="">name</var> argument (in a
-  <a href="#case-sensitive">case-sensitive</a> manner), in <a href="#tree-order">tree order</a>.</p>
+  <a href="#case-sensitive">case-sensitive</a> manner), in <a href="#tree-order">tree order</a>. A
+  new <code>NodeList</code> object must be returned each time unless
+  the argument is the same as the last time the method was invoked on
+  this <code>Document</code> object, in which case the object must be
+  the same as the object returned by the previous call.</p>
 
   <p>The <dfn id="dom-document-getelementsbyclassname" title="dom-document-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method takes a string that
   contains a <a href="#set-of-space-separated-tokens">set of space-separated tokens</a> representing
@@ -6408,8 +6412,11 @@
   <code>NodeList</code>. If the document is in <a href="#quirks-mode">quirks
   mode</a>, then the comparisons for the classes must be done in an
   <a href="#ascii-case-insensitive">ASCII case-insensitive</a> manner, otherwise, the
-  comparisons must be done in a <a href="#case-sensitive">case-sensitive</a>
-  manner.</p>
+  comparisons must be done in a <a href="#case-sensitive">case-sensitive</a> manner. A
+  new <code>NodeList</code> object must be returned each time unless
+  the argument is the same as the last time the method was invoked on
+  this <code>Document</code> object, in which case the object must be
+  the same as the object returned by the previous call.</p>
 
   <p>The <dfn id="dom-getelementsbyclassname" title="dom-getElementsByClassName"><code>getElementsByClassName(<var title="">classNames</var>)</code></dfn> method on the
   <code><a href="#htmlelement">HTMLElement</a></code> interface must return a live
@@ -6417,7 +6424,11 @@
   <code><a href="#htmldocument">HTMLDocument</a></code> <code title="dom-document-getElementsByClassName"><a href="#dom-document-getelementsbyclassname">getElementsByClassName()</a></code>
   method would return when passed the same argument(s), excluding any
   elements that are not descendants of the <code><a href="#htmlelement">HTMLElement</a></code>
-  object on which the method was invoked.</p>
+  object on which the method was invoked. A new <code>NodeList</code>
+  object must be returned each time unless the argument is the same as
+  the last time the method was invoked on this
+  <code><a href="#htmlelement">HTMLElement</a></code> object, in which case the object must be
+  the same as the object returned by the previous call.</p>
 
   </div><p>HTML, SVG, and MathML elements define which classes they are in
   by having an attribute with no namespace with the name <code title="">class</code> containing a space-separated list of classes
@@ -7138,7 +7149,8 @@
   create a <code title="attr-style"><a href="#the-style-attribute">style</a></code> attribute on the
   element (if there isn't one already) and then change its value to be
   a value representing the serialized form of the
-  <code>CSSStyleDeclaration</code> object. <a href="#refsCSSOM">[CSSOM]</a>
+  <code>CSSStyleDeclaration</code> object. The same object must be
+  returned each time. <a href="#refsCSSOM">[CSSOM]</a></p>
 
   </div><div class="example">
 
@@ -7244,7 +7256,9 @@
 
     </ol></dd>
 
-  </dl></div><div class="example">
+  </dl><p>The same object must be returned each time.</p>
+
+  </div><div class="example">
 
    <p>If a Web page wanted an element to represent a space ship,
    e.g. as part of a game, it would have to use the <code title="attr-class"><a href="#classes">class</a></code> attribute along with <code title="attr-data-*"><a href="#attr-data">data-*</a></code> attributes:</p>
@@ -10565,7 +10579,9 @@
    based on the other values)
 -->
 
-  </dl><p>The <dfn id="dom-linkstyle-disabled" title="dom-LinkStyle-disabled"><code>disabled</code></dfn> IDL
+  </dl><p>The same object must be returned each time.</p>
+
+  <p>The <dfn id="dom-linkstyle-disabled" title="dom-LinkStyle-disabled"><code>disabled</code></dfn> IDL
   attribute on <code><a href="#the-link-element">link</a></code> and <code><a href="#the-style-element">style</a></code> elements must
   return false and do nothing on setting, if the <code title="dom-linkstyle-sheet">sheet</code> attribute of their
   <code>LinkStyle</code> interface is null. Otherwise, it must return
@@ -48055,10 +48071,12 @@
   <p>The <dfn id="dom-datatransfer-types" title="dom-DataTransfer-types"><code>types</code></dfn>
   attribute must return a live <code>DOMStringList</code> that
   contains the list of formats that were added to the
-  <code><a href="#datatransfer">DataTransfer</a></code> object in the corresponding <code title="event-dragstart"><a href="#event-dragstart">dragstart</a></code> event.  If any files were
-  included in the drag, then the <code>DOMStringList</code> object
-  must in addition include the string "<code title="">Files</code>". (This value can be distinguished from the
-  other values because it is not lowercase.)</p>
+  <code><a href="#datatransfer">DataTransfer</a></code> object in the corresponding <code title="event-dragstart"><a href="#event-dragstart">dragstart</a></code> event. The same object must
+  be returned each time. If any files were included in the drag, then
+  the <code>DOMStringList</code> object must in addition include the
+  string "<code title="">Files</code>". (This value can be
+  distinguished from the other values because it is not
+  lowercase.)</p>
 
   <p>The <dfn id="dom-datatransfer-cleardata" title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
   method, when called with no arguments, must clear the
Received on Saturday, 13 February 2010 11:26:57 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 18 December 2010 06:14:17 GMT