[html5] r7158 - [giow] (2) Excise all remaining mentions of DOMStringList Affected topics: DOM A [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Jun 28 16:12:27 PDT 2012


Author: ianh
Date: 2012-06-28 16:12:26 -0700 (Thu, 28 Jun 2012)
New Revision: 7158

Modified:
   complete.html
   index
   source
Log:
[giow] (2) Excise all remaining mentions of DOMStringList
Affected topics: DOM APIs, HTML, Microdata

Modified: complete.html
===================================================================
--- complete.html	2012-06-28 22:28:53 UTC (rev 7157)
+++ complete.html	2012-06-28 23:12:26 UTC (rev 7158)
@@ -3857,7 +3857,6 @@
 
      <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=domstringlist><code>DOMStringList</code></dfn> interface</li>
      <li><dfn id=domtokenlist><code>DOMTokenList</code></dfn> interface</li>
      <li><dfn id=domsettabletokenlist><code>DOMSettableTokenList</code></dfn> interface</li>
 
@@ -9333,7 +9332,7 @@
   <pre class=idl>interface <dfn id=htmlpropertiescollection>HTMLPropertiesCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
   // inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>()
   legacycaller getter <a href=#propertynodelist>PropertyNodeList</a>? <a href=#dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem>namedItem</a>(DOMString name); // overrides inherited namedItem()
-  readonly attribute <a href=#domstringlist>DOMStringList</a> <a href=#dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names>names</a>;
+  readonly attribute <span>DOMString</span>[] <a href=#dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names>names</a>;
 };
 
 typedef sequence<any> <dfn id=propertyvaluearray>PropertyValueArray</dfn>;
@@ -9367,7 +9366,7 @@
 
    <dt><var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code></dt>
    <dd>
-    <p>Returns a <code><a href=#domstringlist>DOMStringList</a></code> with the <a href=#property-names>property names</a> of the elements in the collection.</p>
+    <p>Returns an array with the <a href=#property-names>property names</a> of the elements in the collection.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> . <code title=dom-PropertyNodeList-getVlues>getValues</code>()</dt>
@@ -9385,12 +9384,11 @@
   the collection</a>.</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> <code><a href=#domstringlist>DOMStringList</a></code>
-  object giving the <a href=#property-names>property names</a> of all the elements
-  <a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
-  order</a>, but with duplicates removed, leaving only the first
-  occurrence of each name. The same object must be returned each
-  time.</p>
+  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 the
+  <a href=#property-names>property names</a> of all the elements <a href=#represented-by-the-collection>represented by
+  the collection</a>, listed in <a href=#tree-order>tree order</a>, but with
+  duplicates removed, leaving only the first occurrence of each name.
+  The same object must be returned each time.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
   <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
@@ -76971,7 +76969,7 @@
   void <a href=#dom-datatransfer-addelement title=dom-DataTransfer-addElement>addElement</a>(Element element);
 
   /* old interface */
-  readonly attribute <a href=#domstringlist>DOMStringList</a> <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
+  readonly attribute <span>DOMString</span>[] <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
   DOMString <a href=#dom-datatransfer-getdata title=dom-DataTransfer-getData>getData</a>(DOMString format);
   void <a href=#dom-datatransfer-setdata title=dom-DataTransfer-setData>setData</a>(DOMString format, DOMString data);
   void <a href=#dom-datatransfer-cleardata title=dom-DataTransfer-clearData>clearData</a>(optional DOMString format);
@@ -77039,10 +77037,9 @@
 
    <dd>
 
-    <p>Returns a <code><a href=#domstringlist>DOMStringList</a></code> listing the formats that
-    were set in the <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code>
-    event. In addition, if any files are being dragged, then one of
-    the types will be the string "<code title="">Files</code>".</p>
+    <p>Returns an array listing the formats that were set in the <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code> event. In addition, if
+    any files are being dragged, then one of the types will be the
+    string "<code title="">Files</code>".</p>
 
    </dd>
 
@@ -77166,16 +77163,15 @@
   image at the time the method is invoked.</p>
 
   <p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
-  attribute must return a <a href=#live>live</a> <code><a href=#domstringlist>DOMStringList</a></code>
-  giving the strings that the following steps would produce. The same
-  object must be returned each time.</p>
+  attribute must return a <a href=#live>live</a> <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array giving the
+  strings that the following steps would produce. The same object must
+  be returned each time.</p>
 
   <ol><li><p>Start with an empty list <var title="">L</var>.</li>
 
    <li><p>If the <code><a href=#datatransfer>DataTransfer</a></code> object is no longer
-   associated with a <a href=#drag-data-store>drag data store</a>, the
-   <code><a href=#domstringlist>DOMStringList</a></code> is empty. Abort these steps; return the
-   empty list <var title="">L</var>.</li>
+   associated with a <a href=#drag-data-store>drag data store</a>, the array is empty.
+   Abort these steps; return the empty list <var title="">L</var>.</li>
 
    <li><p>For each item in the <a href=#drag-data-store-item-list>drag data store item list</a>
    <!-- in some order...? --> whose <a href=#the-drag-data-item-kind title="the drag data item
@@ -78046,6 +78042,9 @@
     strings</a> must be <a href=#converted-to-ascii-lowercase>converted to ASCII
     lowercase</a>.</p>
 
+    <p>User agents may also add one or more items representing the
+    selection or dragged element(s) in other forms, e.g. as HTML.</p>
+
    </li>
 
    <!-- DND-v2: text/html as an export format -->
@@ -78296,6 +78295,24 @@
          <a href=#immediate-user-selection>immediate user selection</a> anyway.</dd>
 
 
+         <dt>If the <a href=#current-target-element>current target element</a> is an element
+         that itself has an ancestor element with a <code title=attr-dropzone><a href=#the-dropzone-attribute>dropzone</a></code> attribute that <a href=#concept-dropzone-match title=concept-dropzone-match>matches</a> the <a href=#drag-data-store>drag
+         data store</a></dt>
+
+         <dd>
+
+          <p>Let <var title="">new target</var> be the nearest
+          (deepest) such ancestor element.</p>
+
+          <p>If the <a href=#current-target-element>current target element</a> is <var title="">new target</var>, then leave the <a href=#current-target-element>current
+          target element</a> unchanged.</p>
+
+          <p>Otherwise, <a href=#fire-a-dnd-event>fire a DND event</a> named <code title=event-dragenter><a href=#event-dragenter>dragenter</a></code> at <var title="">new target</var>. Then, set the <a href=#current-target-element>current
+          target element</a> to <var title="">new target</var>
+
+         </dd>
+
+
          <dt>If the <a href=#current-target-element>current target element</a> is
          <a href=#the-body-element-0>the body element</a></dt>
 
@@ -78309,11 +78326,13 @@
 
           <p><a href=#fire-a-dnd-event>Fire a DND event</a> named <code title=event-dragenter><a href=#event-dragenter>dragenter</a></code> at <a href=#the-body-element-0>the body
           element</a>, if there is one, or at the
-          <code><a href=#document>Document</a></code> object, if not. Then, and set the
+          <code><a href=#document>Document</a></code> object, if not. Then, set the
           <a href=#current-target-element>current target element</a> to <a href=#the-body-element-0>the body
           element</a>, regardless of whether that event was
           canceled or not.</p>
 
+         </dd>
+
         </dl></dd>
 
       </dl></li>

Modified: index
===================================================================
--- index	2012-06-28 22:28:53 UTC (rev 7157)
+++ index	2012-06-28 23:12:26 UTC (rev 7158)
@@ -3857,7 +3857,6 @@
 
      <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=domstringlist><code>DOMStringList</code></dfn> interface</li>
      <li><dfn id=domtokenlist><code>DOMTokenList</code></dfn> interface</li>
      <li><dfn id=domsettabletokenlist><code>DOMSettableTokenList</code></dfn> interface</li>
 
@@ -9333,7 +9332,7 @@
   <pre class=idl>interface <dfn id=htmlpropertiescollection>HTMLPropertiesCollection</dfn> : <a href=#htmlcollection>HTMLCollection</a> {
   // inherits <span title=dom-HTMLCollection-length>length</span> and <span title=dom-HTMLCollection-item>item</span>()
   legacycaller getter <a href=#propertynodelist>PropertyNodeList</a>? <a href=#dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem>namedItem</a>(DOMString name); // overrides inherited namedItem()
-  readonly attribute <a href=#domstringlist>DOMStringList</a> <a href=#dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names>names</a>;
+  readonly attribute <span>DOMString</span>[] <a href=#dom-htmlpropertiescollection-names title=dom-HTMLPropertiesCollection-names>names</a>;
 };
 
 typedef sequence<any> <dfn id=propertyvaluearray>PropertyValueArray</dfn>;
@@ -9367,7 +9366,7 @@
 
    <dt><var title="">collection</var> . <code title=dom-HTMLPropertiesCollection-names><a href=#dom-htmlpropertiescollection-names>names</a></code></dt>
    <dd>
-    <p>Returns a <code><a href=#domstringlist>DOMStringList</a></code> with the <a href=#property-names>property names</a> of the elements in the collection.</p>
+    <p>Returns an array with the <a href=#property-names>property names</a> of the elements in the collection.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> . <code title=dom-PropertyNodeList-getVlues>getValues</code>()</dt>
@@ -9385,12 +9384,11 @@
   the collection</a>.</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> <code><a href=#domstringlist>DOMStringList</a></code>
-  object giving the <a href=#property-names>property names</a> of all the elements
-  <a href=#represented-by-the-collection>represented by the collection</a>, listed in <a href=#tree-order>tree
-  order</a>, but with duplicates removed, leaving only the first
-  occurrence of each name. The same object must be returned each
-  time.</p>
+  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 the
+  <a href=#property-names>property names</a> of all the elements <a href=#represented-by-the-collection>represented by
+  the collection</a>, listed in <a href=#tree-order>tree order</a>, but with
+  duplicates removed, leaving only the first occurrence of each name.
+  The same object must be returned each time.</p>
 
   <p>The <dfn id=dom-htmlpropertiescollection-nameditem title=dom-HTMLPropertiesCollection-namedItem><code>namedItem(<var title="">name</var>)</code></dfn> method must return a
   <code><a href=#propertynodelist>PropertyNodeList</a></code> object representing a
@@ -76971,7 +76969,7 @@
   void <a href=#dom-datatransfer-addelement title=dom-DataTransfer-addElement>addElement</a>(Element element);
 
   /* old interface */
-  readonly attribute <a href=#domstringlist>DOMStringList</a> <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
+  readonly attribute <span>DOMString</span>[] <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
   DOMString <a href=#dom-datatransfer-getdata title=dom-DataTransfer-getData>getData</a>(DOMString format);
   void <a href=#dom-datatransfer-setdata title=dom-DataTransfer-setData>setData</a>(DOMString format, DOMString data);
   void <a href=#dom-datatransfer-cleardata title=dom-DataTransfer-clearData>clearData</a>(optional DOMString format);
@@ -77039,10 +77037,9 @@
 
    <dd>
 
-    <p>Returns a <code><a href=#domstringlist>DOMStringList</a></code> listing the formats that
-    were set in the <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code>
-    event. In addition, if any files are being dragged, then one of
-    the types will be the string "<code title="">Files</code>".</p>
+    <p>Returns an array listing the formats that were set in the <code title=event-dragstart><a href=#event-dragstart>dragstart</a></code> event. In addition, if
+    any files are being dragged, then one of the types will be the
+    string "<code title="">Files</code>".</p>
 
    </dd>
 
@@ -77166,16 +77163,15 @@
   image at the time the method is invoked.</p>
 
   <p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
-  attribute must return a <a href=#live>live</a> <code><a href=#domstringlist>DOMStringList</a></code>
-  giving the strings that the following steps would produce. The same
-  object must be returned each time.</p>
+  attribute must return a <a href=#live>live</a> <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array giving the
+  strings that the following steps would produce. The same object must
+  be returned each time.</p>
 
   <ol><li><p>Start with an empty list <var title="">L</var>.</li>
 
    <li><p>If the <code><a href=#datatransfer>DataTransfer</a></code> object is no longer
-   associated with a <a href=#drag-data-store>drag data store</a>, the
-   <code><a href=#domstringlist>DOMStringList</a></code> is empty. Abort these steps; return the
-   empty list <var title="">L</var>.</li>
+   associated with a <a href=#drag-data-store>drag data store</a>, the array is empty.
+   Abort these steps; return the empty list <var title="">L</var>.</li>
 
    <li><p>For each item in the <a href=#drag-data-store-item-list>drag data store item list</a>
    <!-- in some order...? --> whose <a href=#the-drag-data-item-kind title="the drag data item
@@ -78046,6 +78042,9 @@
     strings</a> must be <a href=#converted-to-ascii-lowercase>converted to ASCII
     lowercase</a>.</p>
 
+    <p>User agents may also add one or more items representing the
+    selection or dragged element(s) in other forms, e.g. as HTML.</p>
+
    </li>
 
    <!-- DND-v2: text/html as an export format -->
@@ -78296,6 +78295,24 @@
          <a href=#immediate-user-selection>immediate user selection</a> anyway.</dd>
 
 
+         <dt>If the <a href=#current-target-element>current target element</a> is an element
+         that itself has an ancestor element with a <code title=attr-dropzone><a href=#the-dropzone-attribute>dropzone</a></code> attribute that <a href=#concept-dropzone-match title=concept-dropzone-match>matches</a> the <a href=#drag-data-store>drag
+         data store</a></dt>
+
+         <dd>
+
+          <p>Let <var title="">new target</var> be the nearest
+          (deepest) such ancestor element.</p>
+
+          <p>If the <a href=#current-target-element>current target element</a> is <var title="">new target</var>, then leave the <a href=#current-target-element>current
+          target element</a> unchanged.</p>
+
+          <p>Otherwise, <a href=#fire-a-dnd-event>fire a DND event</a> named <code title=event-dragenter><a href=#event-dragenter>dragenter</a></code> at <var title="">new target</var>. Then, set the <a href=#current-target-element>current
+          target element</a> to <var title="">new target</var>
+
+         </dd>
+
+
          <dt>If the <a href=#current-target-element>current target element</a> is
          <a href=#the-body-element-0>the body element</a></dt>
 
@@ -78309,11 +78326,13 @@
 
           <p><a href=#fire-a-dnd-event>Fire a DND event</a> named <code title=event-dragenter><a href=#event-dragenter>dragenter</a></code> at <a href=#the-body-element-0>the body
           element</a>, if there is one, or at the
-          <code><a href=#document>Document</a></code> object, if not. Then, and set the
+          <code><a href=#document>Document</a></code> object, if not. Then, set the
           <a href=#current-target-element>current target element</a> to <a href=#the-body-element-0>the body
           element</a>, regardless of whether that event was
           canceled or not.</p>
 
+         </dd>
+
         </dl></dd>
 
       </dl></li>

Modified: source
===================================================================
--- source	2012-06-28 22:28:53 UTC (rev 7157)
+++ source	2012-06-28 23:12:26 UTC (rev 7158)
@@ -2790,7 +2790,6 @@
 
      <li><dfn><code>HTMLCollection</code></dfn> interface, and the terms <dfn>collections</dfn> and <dfn>represented by the collection</dfn></li>
 
-     <li><dfn><code>DOMStringList</code></dfn> interface</li>
      <li><dfn><code>DOMTokenList</code></dfn> interface</li>
      <li><dfn><code>DOMSettableTokenList</code></dfn> interface</li>
 
@@ -9452,7 +9451,7 @@
   <pre class="idl">interface <dfn>HTMLPropertiesCollection</dfn> : <span>HTMLCollection</span> {
   // inherits <span title="dom-HTMLCollection-length">length</span> and <span title="dom-HTMLCollection-item">item</span>()
   legacycaller getter <span>PropertyNodeList</span>? <span title="dom-HTMLPropertiesCollection-namedItem">namedItem</span>(DOMString name); // overrides inherited namedItem()
-  readonly attribute <span>DOMStringList</span> <span title="dom-HTMLPropertiesCollection-names">names</span>;
+  readonly attribute <span>DOMString</span>[] <span title="dom-HTMLPropertiesCollection-names">names</span>;
 };
 
 typedef sequence<any> <dfn>PropertyValueArray</dfn>;
@@ -9488,7 +9487,7 @@
 
    <dt><var title="">collection</var> . <code title="dom-HTMLPropertiesCollection-names">names</code></dt>
    <dd>
-    <p>Returns a <code>DOMStringList</code> with the <span>property names</span> of the elements in the collection.</p>
+    <p>Returns an array with the <span>property names</span> of the elements in the collection.</p>
    </dd>
 
    <dt><var title="">propertyNodeList</var> . <code title="dom-PropertyNodeList-getVlues">getValues</code>()</dt>
@@ -9509,12 +9508,12 @@
 
   <p>The <dfn
   title="dom-HTMLPropertiesCollection-names"><code>names</code></dfn>
-  attribute must return a <span>live</span> <code>DOMStringList</code>
-  object giving the <span>property names</span> of all the elements
-  <span>represented by the collection</span>, listed in <span>tree
-  order</span>, but with duplicates removed, leaving only the first
-  occurrence of each name. The same object must be returned each
-  time.</p>
+  attribute must return a <span>live</span> <span
+  title="dfn-read-only-array">read only</span> array object giving the
+  <span>property names</span> of all the elements <span>represented by
+  the collection</span>, listed in <span>tree order</span>, but with
+  duplicates removed, leaving only the first occurrence of each name.
+  The same object must be returned each time.</p>
 
   <p>The <dfn
   title="dom-HTMLPropertiesCollection-namedItem"><code>namedItem(<var
@@ -90063,7 +90062,7 @@
   void <span title="dom-DataTransfer-addElement">addElement</span>(Element element);
 
   /* old interface */
-  readonly attribute <span>DOMStringList</span> <span title="dom-DataTransfer-types">types</span>;
+  readonly attribute <span>DOMString</span>[] <span title="dom-DataTransfer-types">types</span>;
   DOMString <span title="dom-DataTransfer-getData">getData</span>(DOMString format);
   void <span title="dom-DataTransfer-setData">setData</span>(DOMString format, DOMString data);
   void <span title="dom-DataTransfer-clearData">clearData</span>(optional DOMString format);
@@ -90140,10 +90139,10 @@
 
    <dd>
 
-    <p>Returns a <code>DOMStringList</code> listing the formats that
-    were set in the <code title="event-dragstart">dragstart</code>
-    event. In addition, if any files are being dragged, then one of
-    the types will be the string "<code title="">Files</code>".</p>
+    <p>Returns an array listing the formats that were set in the <code
+    title="event-dragstart">dragstart</code> event. In addition, if
+    any files are being dragged, then one of the types will be the
+    string "<code title="">Files</code>".</p>
 
    </dd>
 
@@ -90296,18 +90295,19 @@
   image at the time the method is invoked.</p>
 
   <p>The <dfn title="dom-DataTransfer-types"><code>types</code></dfn>
-  attribute must return a <span>live</span> <code>DOMStringList</code>
-  giving the strings that the following steps would produce. The same
-  object must be returned each time.</p>
+  attribute must return a <span>live</span> <span
+  title="dfn-read-only-array">read only</span> array giving the
+  strings that the following steps would produce. The same object must
+  be returned each time.</p>
 
   <ol>
 
    <li><p>Start with an empty list <var title="">L</var>.</p></li>
 
    <li><p>If the <code>DataTransfer</code> object is no longer
-   associated with a <span>drag data store</span>, the
-   <code>DOMStringList</code> is empty. Abort these steps; return the
-   empty list <var title="">L</var>.</p></li>
+   associated with a <span>drag data store</span>, the array is empty.
+   Abort these steps; return the empty list <var
+   title="">L</var>.</p></li>
 
    <li><p>For each item in the <span>drag data store item list</span>
    <!-- in some order...? --> whose <span title="the drag data item
@@ -91356,6 +91356,9 @@
     strings</span> must be <span>converted to ASCII
     lowercase</span>.</p>
 
+    <p>User agents may also add one or more items representing the
+    selection or dragged element(s) in other forms, e.g. as HTML.</p>
+
    </li>
 
    <!-- DND-v2: text/html as an export format -->
@@ -91659,6 +91662,30 @@
          <span>immediate user selection</span> anyway.</p></dd>
 
 
+         <dt>If the <span>current target element</span> is an element
+         that itself has an ancestor element with a <code
+         title="attr-dropzone">dropzone</code> attribute that <span
+         title="concept-dropzone-match">matches</span> the <span>drag
+         data store</span></dt>
+
+         <dd>
+
+          <p>Let <var title="">new target</var> be the nearest
+          (deepest) such ancestor element.</p>
+
+          <p>If the <span>current target element</span> is <var
+          title="">new target</var>, then leave the <span>current
+          target element</span> unchanged.</p>
+
+          <p>Otherwise, <span>fire a DND event</span> named <code
+          title="event-dragenter">dragenter</code> at <var
+          title="">new target</var>. Then, set the <span>current
+          target element</span> to <var title="">new target</var,
+          regardless of whether that event was canceled or not.</p>
+
+         </dd>
+
+
          <dt>If the <span>current target element</span> is
          <span>the body element</span></dt>
 
@@ -91673,11 +91700,13 @@
           <p><span>Fire a DND event</span> named <code
           title="event-dragenter">dragenter</code> at <span>the body
           element</span>, if there is one, or at the
-          <code>Document</code> object, if not. Then, and set the
+          <code>Document</code> object, if not. Then, set the
           <span>current target element</span> to <span>the body
           element</span>, regardless of whether that event was
           canceled or not.</p>
 
+         </dd>
+
         </dl>
 
        </dd>




More information about the Commit-Watchers mailing list