[html5] r3589 - [] (0) DND: Make .types always accessible.
whatwg at whatwg.org
whatwg at whatwg.org
Tue Aug 11 15:44:52 PDT 2009
Author: ianh
Date: 2009-08-11 15:44:51 -0700 (Tue, 11 Aug 2009)
New Revision: 3589
Modified:
index
source
Log:
[] (0) DND: Make .types always accessible.
Modified: index
===================================================================
--- index 2009-08-11 22:23:50 UTC (rev 3588)
+++ index 2009-08-11 22:44:51 UTC (rev 3589)
@@ -59829,9 +59829,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>
@@ -59924,28 +59925,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
@@ -60046,7 +60044,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>
Modified: source
===================================================================
--- source 2009-08-11 22:23:50 UTC (rev 3588)
+++ source 2009-08-11 22:44:51 UTC (rev 3589)
@@ -65547,9 +65547,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">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>
@@ -65653,19 +65654,19 @@
<p>The <dfn 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>DataTransfer</code> object. If any files are stored in the
- <code>DataTransfer</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>DataTransfer</code> object in the corresponding <code
+ title="event-dragstart">dragstart</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">setData()</code> method is invoked
- with the string "<code title="">Files</code>", and some files are
- stored in the <code>DataTransfer</code> object, then the string
- "<code title="">Files</code>" will appear twice in the <code
- title="dom-DataTransfer-types">types</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">types</code> attribute's list.</p>
<p>The <dfn
title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
@@ -65674,13 +65675,12 @@
<p class="note">The <code
title="dom-DataTransfer-clearData">clearData()</code> method does
- not affect whether any files are stored in the
- <code>DataTransfer</code> object, so the <code
+ not affect whether any files were included in the drag, so the <code
title="dom-DataTransfer-types">types</code> attribute's list might
still not be empty after calling <code
title="dom-DataTransfer-clearData">clearData()</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">clearData(<var
@@ -65803,7 +65803,7 @@
<td><span>Source node</span></td>
<td>✓ Bubbles</td>
<td>✓ Cancelable</td>
- <td>Contains <span>source node</span> unless a selection is being dragged, in which case it is empty</td>
+ <td>Contains <span>source node</span> unless a selection is being dragged, in which case it is empty; <code title="dom-datatransfer-files">files</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>
More information about the Commit-Watchers
mailing list