W3C home > Mailing lists > Public > public-html-commits@w3.org > January 2011

html5/spec Overview.html,1.4650,1.4651

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Thu, 20 Jan 2011 20:31:01 +0000
To: public-html-commits@w3.org
Message-Id: <E1Pg19p-0006ot-FO@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv26201

Modified Files:
	Overview.html 
Log Message:
Fix the IDL for DataTransfer, and change the emphasis of the section to put the new API first. (whatwg r5790)

Index: Overview.html
===================================================================
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:31:03 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 20 January 2011 20:31:10 GMT