html5/spec Overview.html,1.2781,1.2782

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv25487

Modified Files:
	Overview.html 
Log Message:
DND: Make .types always accessible. (whatwg r3589)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2781
retrieving revision 1.2782
diff -u -d -r1.2781 -r1.2782
--- Overview.html	11 Aug 2009 22:23:56 -0000	1.2781
+++ Overview.html	11 Aug 2009 22:44:57 -0000	1.2782
@@ -60041,9 +60041,10 @@
 
    <dd>
 
-    <p>Returns a <code>DOMStringList</code> of the formats
-    available. If any files are being dragged, then one of the types
-    will be the string "<code title="">Files</code>".</p>
+    <p>Returns a <code>DOMStringList</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>
 
    </dd>
 
@@ -60136,28 +60137,25 @@
 
   <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 are stored in the
-  <code><a href="#datatransfer">DataTransfer</a></code> object. If any files are stored in the
-  <code><a href="#datatransfer">DataTransfer</a></code> object, then the
-  <code>DOMStringList</code> object must in addition include the
-  string "<code title="">Files</code>".</p>
+  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>".</p>
 
   <p class="note">If the <code title="dom-DataTransfer-setData"><a href="#dom-datatransfer-setdata">setData()</a></code> method is invoked
-  with the string "<code title="">Files</code>", and some files are
-  stored in the <code><a href="#datatransfer">DataTransfer</a></code> object, then the string
-  "<code title="">Files</code>" will appear twice in the <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code> attribute's
-  list.</p>
+  with the string "<code title="">Files</code>", and some files were
+  included in the drag, then the string "<code title="">Files</code>"
+  will appear twice in the <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code> attribute's list.</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
   <code><a href="#datatransfer">DataTransfer</a></code> object of all data (for all formats).</p>
 
   <p class="note">The <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData()</a></code> method does
-  not affect whether any files are stored in the
-  <code><a href="#datatransfer">DataTransfer</a></code> object, so the <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code> attribute's list might
+  not affect whether any files were included in the drag, so the <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code> attribute's list might
   still not be empty after calling <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData()</a></code> (it would
-  still contain the "<code title="">Files</code>" string if there are
-  any files in the object).</p>
+  still contain the "<code title="">Files</code>" string if any files
+  were included in the drag).</p>
 
   <p>When called with an argument, the <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData(<var title="">format</var>)</a></code> method must clear the
   <code><a href="#datatransfer">DataTransfer</a></code> object of any data associated with the
@@ -60258,7 +60256,7 @@
      <td><a href="#source-node">Source node</a></td>
      <td>✓ Bubbles</td>
      <td>✓ Cancelable</td>
-     <td>Contains <a href="#source-node">source node</a> unless a selection is being dragged, in which case it is empty</td>
+     <td>Contains <a href="#source-node">source node</a> unless a selection is being dragged, in which case it is empty; <code title="dom-datatransfer-files"><a href="#dom-datatransfer-files">files</a></code> returns any files included in the drag operation</td>
      <td><code title="">uninitialized</code></td>
      <td><code title="">none</code></td>
      <td>Initiate the drag-and-drop operation</td>

Received on Tuesday, 11 August 2009 22:45:09 UTC