hixie: Make files visible by making 'Files' a magic type in the .types array. (whatwg r3583)

hixie: Make files visible by making 'Files' a magic type in the .types
array. (whatwg r3583)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2775&r2=1.2776&f=h
http://html5.org/tools/web-apps-tracker?from=3582&to=3583

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2775
retrieving revision 1.2776
diff -u -d -r1.2775 -r1.2776
--- Overview.html 11 Aug 2009 05:57:21 -0000 1.2775
+++ Overview.html 11 Aug 2009 06:14:28 -0000 1.2776
@@ -60041,7 +60041,9 @@
 
    <dd>
 
-    <p>Returns a <code>DOMStringList</code> of the formats available.</p>
+    <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>
 
    </dd>
 
@@ -60135,12 +60137,28 @@
   <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.</p>
+  <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>
+
+  <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>
 
   <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
+  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>
+
   <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
   given <var title="">format</var>. If <var title="">format</var> is

Received on Tuesday, 11 August 2009 06:15:22 UTC