- From: poot <cvsmail@w3.org>
- Date: Thu, 20 Jan 2011 15:33:22 -0500
- To: public-html-diffs@w3.org
hixie: Fix the IDL for DataTransfer, and change the emphasis of the
section to put the new API first. (whatwg r5790)
http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4650&r2=1.4651&f=h
http://html5.org/tools/web-apps-tracker?from=5789&to=5790
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4650
retrieving revision 1.4651
diff -u -d -r1.4650 -r1.4651
--- Overview.html 18 Jan 2011 09:18:41 -0000 1.4650
+++ Overview.html 20 Jan 2011 20:30:57 -0000 1.4651
@@ -325,7 +325,7 @@
<h1>HTML5</h1>
<h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
- <h2 class="no-num no-toc" id="editor-s-draft-18-january-2011">Editor's Draft 18 January 2011</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-20-january-2011">Editor's Draft 20 January 2011</h2>
<dl><dt>Latest Published Version:</dt>
<dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
<dt>Latest Editor's Draft:</dt>
@@ -460,7 +460,7 @@
Group</a> is the W3C working group responsible for this
specification's progress along the W3C Recommendation
track.
- This specification is the 18 January 2011 Editor's Draft.
+ This specification is the 20 January 2011 Editor's Draft.
</p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -51129,14 +51129,17 @@
attribute DOMString <a href="#dom-datatransfer-dropeffect" title="dom-DataTransfer-dropEffect">dropEffect</a>;
attribute DOMString <a href="#dom-datatransfer-effectallowed" title="dom-DataTransfer-effectAllowed">effectAllowed</a>;
- readonly attribute DOMStringList <a href="#dom-datatransfer-types" title="dom-DataTransfer-types">types</a>;
- void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(in optional DOMString format);
- void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(in DOMString format, in DOMString data);
- DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(in DOMString format);
- readonly attribute <span>FileList</span> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
+ readonly attribute <a href="#datatransferitems">DataTransferItems</a> <a href="#dom-datatransfer-items" title="dom-DataTransfer-items">items</a>;
void <a href="#dom-datatransfer-setdragimage" title="dom-DataTransfer-setDragImage">setDragImage</a>(in Element image, in long x, in long y);
void <a href="#dom-datatransfer-addelement" title="dom-DataTransfer-addElement">addElement</a>(in Element element);
+
+ /* old interface */
+ readonly attribute DOMStringList <a href="#dom-datatransfer-types" title="dom-DataTransfer-types">types</a>;
+ DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(in DOMString format);
+ void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(in DOMString format, in DOMString data);
+ void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(in optional DOMString format);
+ readonly attribute <span>FileList</span> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
};</pre><dl class="domintro"><dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-dropEffect"><a href="#dom-datatransfer-dropeffect">dropEffect</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -51152,6 +51155,7 @@
</dd>
+
<dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-effectAllowed"><a href="#dom-datatransfer-effectallowed">effectAllowed</a></code> [ = <var title="">value</var> ]</dt>
<dd>
@@ -51164,34 +51168,46 @@
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code></dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-items"><a href="#dom-datatransfer-items">items</a></code></dt>
<dd>
- <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>
+ <p>Returns a <code><a href="#datatransferitems">DataTransferItems</a></code> object, with the drag data.</p>
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData</a></code>( [ <var title="">format</var> ] )</dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setDragImage"><a href="#dom-datatransfer-setdragimage">setDragImage</a></code>(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>)</dt>
<dd>
- <p>Removes the data of the specified formats. Removes all data if
- the argument is omitted.</p>
+ <p>Uses the given element to update the drag feedback, replacing any previously specified feedback.</p>
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setData"><a href="#dom-datatransfer-setdata">setData</a></code>(<var title="">format</var>, <var title="">data</var>)</dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-addElement"><a href="#dom-datatransfer-addelement">addElement</a></code>(<var title="">element</var>)</dt>
<dd>
- <p>Adds the specified data.</p>
+ <p>Adds the given element to the list of elements used to render the drag feedback.</p>
</dd>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-types"><a href="#dom-datatransfer-types">types</a></code></dt>
+
+ <dd>
+
+ <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>
+
+
<dt><var title="">data</var> = <var title="">dataTransfer</var> . <code title="dom-DataTransfer-getData"><a href="#dom-datatransfer-getdata">getData</a></code>(<var title="">format</var>)</dt>
<dd>
@@ -51200,27 +51216,31 @@
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-files"><a href="#dom-datatransfer-files">files</a></code></dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setData"><a href="#dom-datatransfer-setdata">setData</a></code>(<var title="">format</var>, <var title="">data</var>)</dt>
<dd>
- <p>Returns a <code>FileList</code> of the files being dragged, if any.</p>
+ <p>Adds the specified data.</p>
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setDragImage"><a href="#dom-datatransfer-setdragimage">setDragImage</a></code>(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>)</dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData</a></code>( [ <var title="">format</var> ] )</dt>
<dd>
- <p>Uses the given element to update the drag feedback, replacing any previously specified feedback.</p>
+ <p>Removes the data of the specified formats. Removes all data if
+ the argument is omitted.</p>
</dd>
- <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-addElement"><a href="#dom-datatransfer-addelement">addElement</a></code>(<var title="">element</var>)</dt>
+
+ <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-files"><a href="#dom-datatransfer-files">files</a></code></dt>
<dd>
- <p>Adds the given element to the list of elements used to render the drag feedback.</p>
+ <p>Returns a <code>FileList</code> of the files being dragged, if any.</p>
</dd>
@@ -51249,6 +51269,56 @@
current value. On setting, if the new value is one of "<code title="">none</code>", "<code title="">copy</code>", "<code title="">copyLink</code>", "<code title="">copyMove</code>", "<code title="">link</code>", "<code title="">linkMove</code>", "<code title="">move</code>", "<code title="">all</code>", or "<code title="">uninitialized</code>", then the attribute's current value
must be set to the new value. Other values must be ignored.</p>
+ <p>The <dfn id="dom-datatransfer-items" title="dom-DataTransfer-items"><code>items</code></dfn>
+ attribute must return a <code><a href="#datatransferitems">DataTransferItems</a></code> object
+ associated with the <code><a href="#datatransfer">DataTransfer</a></code> object. The same
+ object must be returned each time.</p>
+
+ <p>The <dfn id="dom-datatransfer-setdragimage" title="dom-DataTransfer-setDragImage"><code>setDragImage(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>)</code></dfn> method must run the following
+ steps:</p>
+
+ <ol><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>, abort these steps.
+ Nothing happens.</li>
+
+ <li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
+ store mode">mode</a> is not in the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
+ Nothing happens.</li>
+
+ <li><p>If the <var title="">element</var> argument is an
+ <code><a href="#the-img-element">img</a></code> element, then set the <a href="#drag-data-store-bitmap">drag data store
+ bitmap</a> to the element's image (at its intrinsic size);
+ otherwise, set the <a href="#drag-data-store-bitmap">drag data store bitmap</a> to an image
+ generated from the given element (the exact mechanism for doing so
+ is not currently specified).</li>
+
+ <li><p>Set the <a href="#drag-data-store-hot-spot-coordinate">drag data store hot spot coordinate</a> to
+ the given <var title="">x</var>, <var title="">y</var>
+ coordinate.</li>
+
+ </ol><p>The <dfn id="dom-datatransfer-addelement" title="dom-DataTransfer-addElement"><code>addElement(<var title="">element</var>)</code></dfn> method is an alternative way of
+ specifying how the user agent is to <a href="#base-dnd-feedback">render the drag feedback</a>. The method
+ must run the following steps:</p>
+
+ <ol><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>, abort these steps.
+ Nothing happens.</li>
+
+ <li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
+ store mode">mode</a> is not in the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
+ Nothing happens.</li>
+
+ <li><p>Add the given <var title="">element</var> to the element's
+ <a href="#drag-data-store-elements-list">drag data store elements list</a>.</li>
+
+ </ol><p class="note">The difference between <code title="dom-DataTransfer-setDragImage"><a href="#dom-datatransfer-setdragimage">setDragImage()</a></code> and
+ <code title="dom-DataTransfer-addElement"><a href="#dom-datatransfer-addelement">addElement()</a></code> is
+ that the latter automatically generates the image based on the
+ current rendering of the elements added (potentially keeping it
+ updated as the drag continues, e.g. if the elements include an
+ actively playing video), whereas the former uses the exact specified
+ 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>DOMStringList</code>
giving the strings that the following steps would produce. The same
@@ -51278,44 +51348,44 @@
<li><p>The strings produced by these steps are those in the list
<var title="">L</var>.</li>
- </ol><p>The <dfn id="dom-datatransfer-cleardata" title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
- method must run the following steps:</p>
+ </ol><p>The <dfn id="dom-datatransfer-getdata" title="dom-DataTransfer-getData"><code>getData(<var title="">format</var>, <var title="">data</var>)</code></dfn> method
+ must run the following steps:</p>
<ol><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>, abort these steps.
Nothing happens.</li>
<li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
- store mode">mode</a> is not the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
+ store mode">mode</a> is in the <a href="#concept-dnd-p" title="concept-dnd-p">protected mode</a>, abort these steps.
Nothing happens.</li>
- <li><p>If the method was called with no arguments, remove each item
- in the <a href="#drag-data-store-item-list">drag data store item list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is <i>Plain Unicode
- string</i>, and abort these steps.</li>
-
<li><p>Let <var title="">format</var> be the first argument,
<a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</li>
- <li>
-
- <p>If <var title="">format</var> equals "<code title="">text</code>", change it to "<code title="">text/plain</code>".</p>
+ <li><p>Let <var title="">convert-to-URL</var> be false.</li>
- <p>If <var title="">format</var> equals "<code title="">url</code>", change it to "<code title="">text/uri-list</code>".</p>
+ <li><p>If <var title="">format</var> equals "<code title="">text</code>", change it to "<code title="">text/plain</code>".</li>
- </li>
+ <li><p>If <var title="">format</var> equals "<code title="">url</code>", change it to "<code title="">text/uri-list</code>" and set <var title="">convert-to-URL</var> to true.</li>
- <li><p>Remove the item in the <a href="#drag-data-store-item-list">drag data store item
+ <li><p>If there is no item in the <a href="#drag-data-store-item-list">drag data store item
list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a>
is <i>Plain Unicode string</i> and whose <a href="#the-drag-data-item-type-string" title="the drag data
- item type string">type string</a> is equal to <var title="">format</var>, if there is one.</li>
+ item type string">type string</a> is equal to <var title="">format</var>, return the empty string and abort these
+ steps.</li>
- </ol><p class="note">The <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData()</a></code> method does
- 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 any files
- were included in the drag).</p>
+ <li><p>Let <var title="">result</var> be the data of the item
+ in the <a href="#drag-data-store-item-list">drag data store item list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is <i>Plain Unicode
+ string</i> and whose <a href="#the-drag-data-item-type-string" title="the drag data item type
+ string">type string</a> is equal to <var title="">format</var>.</li>
- <p>The <dfn id="dom-datatransfer-setdata" title="dom-DataTransfer-setData"><code>setData(<var title="">format</var>, <var title="">data</var>)</code></dfn> method
+ <li><p>If <var title="">convert-to-URL</var> is true, then parse
+ <var title="">result</var> as appropriate for <code title="">text/uri-list</code> data, and then set <var title="">result</var> to the first URL from the list, if any, or
+ the empty string otherwise. <a href="#refsRFC2483">[RFC2483]</a></li>
+
+ <li><p>Return <var title="">result</var>.</li>
+
+ </ol><p>The <dfn id="dom-datatransfer-setdata" title="dom-DataTransfer-setData"><code>setData(<var title="">format</var>, <var title="">data</var>)</code></dfn> method
must run the following steps:</p>
<ol><li><p>If the <code><a href="#datatransfer">DataTransfer</a></code> object is no longer
@@ -51349,44 +51419,44 @@
and whose data is the string given by the method's second
argument.</li>
- </ol><p>The <dfn id="dom-datatransfer-getdata" title="dom-DataTransfer-getData"><code>getData(<var title="">format</var>, <var title="">data</var>)</code></dfn> method
- must run the following steps:</p>
+ </ol><p>The <dfn id="dom-datatransfer-cleardata" title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
+ method must run the following steps:</p>
<ol><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>, abort these steps.
Nothing happens.</li>
<li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
- store mode">mode</a> is in the <a href="#concept-dnd-p" title="concept-dnd-p">protected mode</a>, abort these steps.
+ store mode">mode</a> is not the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
Nothing happens.</li>
+ <li><p>If the method was called with no arguments, remove each item
+ in the <a href="#drag-data-store-item-list">drag data store item list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is <i>Plain Unicode
+ string</i>, and abort these steps.</li>
+
<li><p>Let <var title="">format</var> be the first argument,
<a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</li>
- <li><p>Let <var title="">convert-to-URL</var> be false.</li>
+ <li>
- <li><p>If <var title="">format</var> equals "<code title="">text</code>", change it to "<code title="">text/plain</code>".</li>
+ <p>If <var title="">format</var> equals "<code title="">text</code>", change it to "<code title="">text/plain</code>".</p>
- <li><p>If <var title="">format</var> equals "<code title="">url</code>", change it to "<code title="">text/uri-list</code>" and set <var title="">convert-to-URL</var> to true.</li>
+ <p>If <var title="">format</var> equals "<code title="">url</code>", change it to "<code title="">text/uri-list</code>".</p>
- <li><p>If there is no item in the <a href="#drag-data-store-item-list">drag data store item
+ </li>
+
+ <li><p>Remove the item in the <a href="#drag-data-store-item-list">drag data store item
list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a>
is <i>Plain Unicode string</i> and whose <a href="#the-drag-data-item-type-string" title="the drag data
- item type string">type string</a> is equal to <var title="">format</var>, return the empty string and abort these
- steps.</li>
-
- <li><p>Let <var title="">result</var> be the data of the item
- in the <a href="#drag-data-store-item-list">drag data store item list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is <i>Plain Unicode
- string</i> and whose <a href="#the-drag-data-item-type-string" title="the drag data item type
- string">type string</a> is equal to <var title="">format</var>.</li>
-
- <li><p>If <var title="">convert-to-URL</var> is true, then parse
- <var title="">result</var> as appropriate for <code title="">text/uri-list</code> data, and then set <var title="">result</var> to the first URL from the list, if any, or
- the empty string otherwise. <a href="#refsRFC2483">[RFC2483]</a></li>
+ item type string">type string</a> is equal to <var title="">format</var>, if there is one.</li>
- <li><p>Return <var title="">result</var>.</li>
+ </ol><p class="note">The <code title="dom-DataTransfer-clearData"><a href="#dom-datatransfer-cleardata">clearData()</a></code> method does
+ 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 any files
+ were included in the drag).</p>
- </ol><p>The <dfn id="dom-datatransfer-files" title="dom-DataTransfer-files"><code>files</code></dfn>
+ <p>The <dfn id="dom-datatransfer-files" title="dom-DataTransfer-files"><code>files</code></dfn>
attribute must return a <a href="#live">live</a> <code>FileList</code>
sequence consisting of <code>File</code> objects representing the
files found by the following steps. The same object must be returned
@@ -51419,56 +51489,6 @@
</ol><p class="note">This version of the API does not expose the types of
the files during the drag.</p>
- <p>The <dfn id="dom-datatransfer-items" title="dom-DataTransfer-items"><code>items</code></dfn>
- attribute must return a <code><a href="#datatransferitems">DataTransferItems</a></code> object
- associated with the <code><a href="#datatransfer">DataTransfer</a></code> object. The same
- object must be returned each time.</p>
-
- <p>The <dfn id="dom-datatransfer-setdragimage" title="dom-DataTransfer-setDragImage"><code>setDragImage(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>)</code></dfn> method must run the following
- steps:</p>
-
- <ol><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>, abort these steps.
- Nothing happens.</li>
-
- <li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
- store mode">mode</a> is not in the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
- Nothing happens.</li>
-
- <li><p>If the <var title="">element</var> argument is an
- <code><a href="#the-img-element">img</a></code> element, then set the <a href="#drag-data-store-bitmap">drag data store
- bitmap</a> to the element's image (at its intrinsic size);
- otherwise, set the <a href="#drag-data-store-bitmap">drag data store bitmap</a> to an image
- generated from the given element (the exact mechanism for doing so
- is not currently specified).</li>
-
- <li><p>Set the <a href="#drag-data-store-hot-spot-coordinate">drag data store hot spot coordinate</a> to
- the given <var title="">x</var>, <var title="">y</var>
- coordinate.</li>
-
- </ol><p>The <dfn id="dom-datatransfer-addelement" title="dom-DataTransfer-addElement"><code>addElement(<var title="">element</var>)</code></dfn> method is an alternative way of
- specifying how the user agent is to <a href="#base-dnd-feedback">render the drag feedback</a>. The method
- must run the following steps:</p>
-
- <ol><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>, abort these steps.
- Nothing happens.</li>
-
- <li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
- store mode">mode</a> is not in the <a href="#concept-dnd-rw" title="concept-dnd-rw">read/write mode</a>, abort these steps.
- Nothing happens.</li>
-
- <li><p>Add the given <var title="">element</var> to the element's
- <a href="#drag-data-store-elements-list">drag data store elements list</a>.</li>
-
- </ol><p class="note">The difference between <code title="dom-DataTransfer-setDragImage"><a href="#dom-datatransfer-setdragimage">setDragImage()</a></code> and
- <code title="dom-DataTransfer-addElement"><a href="#dom-datatransfer-addelement">addElement()</a></code> is
- that the latter automatically generates the image based on the
- current rendering of the elements added (potentially keeping it
- updated as the drag continues, e.g. if the elements include an
- actively playing video), whereas the former uses the exact specified
- image at the time the method is invoked.</p>
-
</div><h5 id="the-datatransferitems-interface"><span class="secno">7.7.3.1 </span>The <code><a href="#datatransferitems">DataTransferItems</a></code> interface</h5><p>Each <code><a href="#datatransfer">DataTransfer</a></code> object is associated with a
<code><a href="#datatransferitems">DataTransferItems</a></code> object.<pre class="idl">interface <dfn id="datatransferitems">DataTransferItems</dfn> {
readonly attribute unsigned long <a href="#dom-datatransferitems-length" title="dom-DataTransferItems-length">length</a>;
Received on Thursday, 20 January 2011 20:33:24 UTC