[giow] (3) Try to define order for supported property names. This is …

…not based on testing. If there are compatibility constraints here that prevent implementing this as specced, please let me know. Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=20395 Affected topics: DOM APIs, HTML, Microdata, Workers git-svn-id: http://svn.whatwg.org/webapps@7722 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Feb 13, 2013 · a1ff0f3 · a1ff0f3
1 parent 45ae61a
commit a1ff0f3
Show file tree

Hide file tree

Showing 3 changed files with 89 additions and 37 deletions.
diff --git a/complete.html b/complete.html
@@ -248,7 +248,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 12 February 2013</h2>
+    <h2 class="no-num no-toc">Living Standard &mdash; Last Updated 13 February 2013</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -3571,6 +3571,7 @@ <h4 id=dependencies><span class=secno>2.2.2 </span>Dependencies</h4>
 
      <li>The <dfn id=concept-node-insert title=concept-node-insert>insert</dfn>, <dfn id=concept-node-append title=concept-node-append>append</dfn>, <dfn id=concept-node-remove title=concept-node-remove>remove</dfn>, and <dfn id=concept-node-replace title=concept-node-replace>replace</dfn> algorithms for nodes</li>
      <li>The <dfn id=nodes-are-inserted>nodes are inserted</dfn> and <dfn id=nodes-are-removed>nodes are removed</dfn> concepts</li>
+     <li>The <dfn id=attribute-list>attribute list</dfn> concept.</li>
 
      <li><dfn id=event><code>Event</code></dfn> interface</li>
      <li><dfn id=eventtarget><code>EventTarget</code></dfn> interface</li>
@@ -7581,7 +7582,9 @@ <h5 id=htmlformcontrolscollection-0><span class=secno>2.7.2.2 </span>HTMLFormCon
   <code><a href=#htmlcollection>HTMLCollection</a></code> objects.</p>
 
   <p>The <a href=#supported-property-names>supported property names</a> consist of the values of all the <code title=attr-id><a href=#the-id-attribute>id</a></code> and <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attributes of all the
-  elements <a href=#represented-by-the-collection>represented by the collection</a>.</p>
+  elements <a href=#represented-by-the-collection>represented by the collection</a>, in <a href=#tree-order>tree order</a>, ignoring later
+  duplicates, with the <code title=attr-id><a href=#the-id-attribute>id</a></code> of an element preceding its <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> if it has both, they differ from each other, and neither is the
+  duplicate of an earlier entry.</p>
 
   <p>The <dfn id=dom-htmlformcontrolscollection-nameditem title=dom-HTMLFormControlsCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must act according to the following algorithm:</p>
 
@@ -7710,7 +7713,9 @@ <h5 id=htmloptionscollection-0><span class=secno>2.7.2.3 </span>HTMLOptionsColle
   <code><a href=#the-optgroup-element>optgroup</a></code> elements (though it can remove children from them).</p>
 
   <p>The <a href=#supported-property-names>supported property names</a> consist of the values of all the <code title=attr-id><a href=#the-id-attribute>id</a></code> and <code title=attr-option-name><a href=#attr-option-name>name</a></code> attributes of all the
-  elements <a href=#represented-by-the-collection>represented by the collection</a>.</p>
+  elements <a href=#represented-by-the-collection>represented by the collection</a>, in <a href=#tree-order>tree order</a>, ignoring later
+  duplicates, with the <code title=attr-id><a href=#the-id-attribute>id</a></code> of an element preceding its <code title=attr-option-name><a href=#attr-option-name>name</a></code> if it has both, they differ from each other, and neither is
+  the duplicate of an earlier entry.</p>
 
   <p>The <dfn id=dom-htmloptionscollection-nameditem title=dom-HTMLOptionsCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return the first node in the collection that has
   either an <code title=attr-id><a href=#the-id-attribute>id</a></code> attribute or a <code title=attr-option-name><a href=#attr-option-name>name</a></code> attribute equal to <var title="">name</var>, if there is one;
@@ -7841,7 +7846,8 @@ <h5 id=htmlpropertiescollection-0><span class=secno>2.7.2.4 </span>HTMLPropertie
   <code><a href=#htmlcollection>HTMLCollection</a></code> objects.</p>
 
   <p>The <a href=#supported-property-names>supported property names</a> consist of the <a href=#property-names>property names</a> of all the
-  elements <a href=#represented-by-the-collection>represented by the collection</a>.</p>
+  elements <a href=#represented-by-the-collection>represented by the collection</a>, in <a href=#tree-order>tree order</a>, ignoring later
+  duplicates.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names><code>names</code></dfn> attribute must
   return a <a href=#live>live</a> <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array object giving
@@ -7887,7 +7893,7 @@ <h4 id=domstringmap-0><span class=secno>2.7.3 </span>DOMStringMap</h4>
 
   <p>The <a href=#supported-property-names>supported property names</a> on a <code><a href=#domstringmap>DOMStringMap</a></code> object at any instant
   are the names of each pair returned from the algorithm for getting the list of name-value pairs at
-  that instant.</p>
+  that instant, in the order returned.</p>
 
   <p>To <dfn id=dom-domstringmap-nameditem title=dom-DOMStringMap-namedItem>determine the value of a named property</dfn> <var title="">name</var> in a <code><a href=#domstringmap>DOMStringMap</a></code>, the user agent must return the value component
   of the name-value pair whose name component is <var title="">name</var> in the list returned by
@@ -7956,7 +7962,7 @@ <h4 id=domelementmap-0><span class=secno>2.7.4 </span>DOMElementMap</h4>
 
   <p>The <a href=#supported-property-names>supported property names</a> on a <code><a href=#domelementmap>DOMElementMap</a></code> object at any instant
   are the names for each mapping returned from the algorithm for getting the list of name-element
-  mappings at that instant.</p>
+  mappings at that instant, in the order returned.</p>
 
   <p>To <dfn id=dom-domelementmap-nameditem title=dom-DOMElementMap-namedItem>determine the value of a named property</dfn> <var title="">name</var> in a <code><a href=#domelementmap>DOMElementMap</a></code>, the user agent must return the element
   component of the name-element mapping whose name component is <var title="">name</var> in the list
@@ -8853,7 +8859,8 @@ <h4 id=dom-tree-accessors><span class=secno>3.1.4 </span><dfn>DOM tree accessors
   attributes, and the values of the <code title=attr-id><a href=#the-id-attribute>id</a></code> content attributes of all the
     <code><a href=#the-img-element>img</a></code>
   elements in the <code><a href=#document>Document</a></code> that have both <code title=attr-name>name</code> content
-  attributes and <code title=attr-id><a href=#the-id-attribute>id</a></code> content attributes.</p>
+  attributes and <code title=attr-id><a href=#the-id-attribute>id</a></code> content attributes. The <a href=#supported-property-names>supported property
+  names</a> must be in <a href=#tree-order>tree order</a>, ignoring later duplicates.</p>
 
   <p>To <a href=#determine-the-value-of-a-named-property>determine the value of a named property</a> <var title="">name</var> when <dfn id=dom-document-nameditem title=dom-document-namedItem>the <code>Document</code> object is indexed for property
   retrieval</dfn>, the user agent must return the value obtained using the following steps:</p>
@@ -10013,8 +10020,11 @@ <h5 id=embedding-custom-non-visible-data-with-the-data-*-attributes><span class=
     <ol><li>Let <var title="">list</var> be an empty list of name-value
      pairs.</li>
 
+<!--CLEANUP-->
      <li>For each content attribute on the element whose first five characters are the string "<code title="">data-</code>" and whose remaining characters (if any) do not include any
-     <a href=#uppercase-ascii-letters>uppercase ASCII letters</a>, add a name-value pair to <var title="">list</var> whose
+     <a href=#uppercase-ascii-letters>uppercase ASCII letters</a>,
+     in the order that those attributes are listed in the element's <span>attributes list</span>,
+     add a name-value pair to <var title="">list</var> whose
      name is the attribute's name with the first five characters removed and whose value is the
      attribute's value.</li>
 
@@ -43611,7 +43621,7 @@ <h4 id=categories><span class=secno>4.10.2 </span>Categories</h4>
   boolean <a href=#dom-form-checkvalidity title=dom-form-checkValidity>checkValidity</a>();
 };</pre>
    </dd>
-  </dl><!--TOPIC:HTML--><p>The <code><a href=#the-form-element>form</a></code> element <a href=#represents>represents</a> a
+  </dl><!--TOPIC:HTML--><!--CLEANUP--><p>The <code><a href=#the-form-element>form</a></code> element <a href=#represents>represents</a> a
   collection of <a href=#form-associated-element title="form-associated element">form-associated
   elements</a>, some of which can represent editable values that
   can be submitted to a server for processing.</p>
@@ -43765,7 +43775,10 @@ <h4 id=categories><span class=secno>4.10.2 </span>Categories</h4>
   <p>The <a href=#supported-property-names>supported property names</a> consist of the values
   of all the <code title=attr-id><a href=#the-id-attribute>id</a></code> and <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attributes of all the <a href=#category-listed title=category-listed>listed elements</a> and <code><a href=#the-img-element>img</a></code>
   elements that are descendants of the <code><a href=#the-form-element>form</a></code> element, and
-  all the names currently in the <a href=#past-names-map>past names map</a>.</p>
+  all the names currently in the <a href=#past-names-map>past names map</a>, in <a href=#tree-order>tree order</a>, with <code title=attr-id><a href=#the-id-attribute>id</a></code> attributes preceding <code title=attr-fe-name><a href=#attr-fe-name>name</a></code> attributes
+  preceding entries from the <a href=#past-names-map>past names map</a>, with multiple entries in the <a href=#past-names-map>past
+  names map</a> for the same element being ordered chronologically by when they were added to the
+  map, and in all cases ignoring later duplicates.</p>
 
   <p>When a <code><a href=#the-form-element>form</a></code> element is <dfn id=dom-form-nameditem title=dom-form-namedItem>indexed for named property
   retrieval</dfn>, the user agent must run the following steps:</p>
@@ -65204,7 +65217,8 @@ <h4 id=named-access-on-the-window-object><span class=secno>6.2.4 </span>Named ac
   </dl><div class=impl>
 
   <p>The <code><a href=#window>Window</a></code> interface <a href=#support-named-properties title="support named properties">supports named
-  properties</a>. The <a href=#supported-property-names>supported property names</a> at any moment consist of:</p>
+  properties</a>. The <a href=#supported-property-names>supported property names</a> at any moment consist of the
+  following, in <a href=#tree-order>tree order</a>, ignoring later duplicates:</p>
 
   <ul><li>the <a href=#browsing-context-name>browsing context name</a> of any <a href=#child-browsing-context>child browsing context</a> of the
    <a href=#active-document>active document</a> whose name is not the empty string,</li>
@@ -79986,7 +80000,7 @@ <h3 id=apis-available-to-workers><span class=secno>9.3 </span>APIs available to
 
   <p>The DOM APIs &mdash; specifically, all the interfaces defind in the DOM specification other
   than exceptions &mdash; must not be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript
-  global environment</a> is a <a href=#worker-environment>worker environment</a>. <a href=#hrefDOMCORE>[DOMCORE]</a></p>
+  global environment</a> is a <a href=#worker-environment>worker environment</a>. <a href=#refsDOM>[DOM]</a></p>
 
 
   <h4 id=importing-scripts-and-libraries><span class=secno>9.3.1 </span>Importing scripts and libraries</h4>
@@ -83099,6 +83113,7 @@ <h3 id=storage><span class=secno>11.2 </span>The API</h3>
 
   <h4 id=the-storage-interface><span class=secno>11.2.1 </span>The <code><a href=#storage-0>Storage</a></code> interface</h4>
 
+<!--CLEANUP-->
   <pre class=idl>interface <dfn id=storage-0>Storage</dfn> {
   readonly attribute unsigned long <a href=#dom-storage-length title=dom-Storage-length>length</a>;
   DOMString? <a href=#dom-storage-key title=dom-Storage-key>key</a>(unsigned long index);
@@ -83148,7 +83163,8 @@ <h4 id=the-storage-interface><span class=secno>11.2.1 </span>The <code><a href=#
 
   <p>The <a href=#supported-property-names>supported property names</a> on a
   <code><a href=#storage-0>Storage</a></code> object are the keys of each key/value pair
-  currently present in the list associated with the object.</p>
+  currently present in the list associated with the object, in the order that the keys were last
+  added to the storage area.</p>
 
   <p>The <dfn id=dom-storage-getitem title=dom-Storage-getItem><code>getItem(<var title="">key</var>)</code></dfn> method must return
   the current value associated with