[html5] r5790 - [giow] (0) Fix the IDL for DataTransfer, and change the emphasis of the section [...]

whatwg at whatwg.org whatwg at whatwg.org
Thu Jan 20 12:30:51 PST 2011


Author: ianh
Date: 2011-01-20 12:30:50 -0800 (Thu, 20 Jan 2011)
New Revision: 5790

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Fix the IDL for DataTransfer, and change the emphasis of the section to put the new API first.

Modified: complete.html
===================================================================
--- complete.html	2011-01-20 06:18:53 UTC (rev 5789)
+++ complete.html	2011-01-20 20:30:50 UTC (rev 5790)
@@ -221,7 +221,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 19 January 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 20 January 2011</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -67764,14 +67764,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 <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);
-  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>;
-
-  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);
 };</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>
@@ -67789,6 +67792,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>
@@ -67801,34 +67805,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>
@@ -67837,27 +67853,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>
 
@@ -67888,6 +67908,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
@@ -67917,44 +67987,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>
+   <li><p>Let <var title="">convert-to-URL</var> be false.</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="">text</code>", change it to "<code title="">text/plain</code>".</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="">url</code>", change it to "<code title="">text/uri-list</code>" and set <var title="">convert-to-URL</var> to true.</li>
 
-   </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
@@ -67988,44 +68058,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>
+   item type string">type string</a> is equal to <var title="">format</var>, if there is one.</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>
+  </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>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-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
@@ -68058,56 +68128,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>
 
 

Modified: index
===================================================================
--- index	2011-01-20 06:18:53 UTC (rev 5789)
+++ index	2011-01-20 20:30:50 UTC (rev 5790)
@@ -225,7 +225,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 19 January 2011</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 20 January 2011</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -67772,14 +67772,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 <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);
-  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>;
-
-  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);
 };</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>
@@ -67797,6 +67800,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>
@@ -67809,34 +67813,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>
@@ -67845,27 +67861,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>
 
@@ -67896,6 +67916,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
@@ -67925,44 +67995,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>
+   <li><p>Let <var title="">convert-to-URL</var> be false.</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="">text</code>", change it to "<code title="">text/plain</code>".</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="">url</code>", change it to "<code title="">text/uri-list</code>" and set <var title="">convert-to-URL</var> to true.</li>
 
-   </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
@@ -67996,44 +68066,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>
+   item type string">type string</a> is equal to <var title="">format</var>, if there is one.</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>
+  </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>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-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
@@ -68066,56 +68136,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>
 
 

Modified: source
===================================================================
--- source	2011-01-20 06:18:53 UTC (rev 5789)
+++ source	2011-01-20 20:30:50 UTC (rev 5790)
@@ -77191,14 +77191,17 @@
            attribute DOMString <span title="dom-DataTransfer-dropEffect">dropEffect</span>;
            attribute DOMString <span title="dom-DataTransfer-effectAllowed">effectAllowed</span>;
 
+  readonly attribute <span>DataTransferItems</span> <span title="dom-DataTransfer-items">items</span>;
+
+  void <span title="dom-DataTransfer-setDragImage">setDragImage</span>(in Element image, in long x, in long y);
+  void <span title="dom-DataTransfer-addElement">addElement</span>(in Element element);
+
+  /* old interface */
   readonly attribute DOMStringList <span title="dom-DataTransfer-types">types</span>;
+  DOMString <span title="dom-DataTransfer-getData">getData</span>(in DOMString format);
+  void <span title="dom-DataTransfer-setData">setData</span>(in DOMString format, in DOMString data);
   void <span title="dom-DataTransfer-clearData">clearData</span>(in optional DOMString format);
-  void <span title="dom-DataTransfer-setData">setData</span>(in DOMString format, in DOMString data);
-  DOMString <span title="dom-DataTransfer-getData">getData</span>(in DOMString format);
   readonly attribute <span>FileList</span> <span title="dom-DataTransfer-files">files</span>;
-
-  void <span title="dom-DataTransfer-setDragImage">setDragImage</span>(in Element image, in long x, in long y);
-  void <span title="dom-DataTransfer-addElement">addElement</span>(in Element element);
 };</pre>
 
   <dl class="domintro">
@@ -77220,6 +77223,7 @@
 
    </dd>
 
+
    <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-effectAllowed">effectAllowed</code> [ = <var title="">value</var> ]</dt>
 
    <dd>
@@ -77236,34 +77240,46 @@
 
    </dd>
 
-   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-types">types</code></dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-items">items</code></dt>
+
    <dd>
 
-    <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>
+    <p>Returns a <code>DataTransferItems</code> object, with the drag data.</p>
 
    </dd>
 
-   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-clearData">clearData</code>( [ <var title="">format</var> ] )</dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setDragImage">setDragImage</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">setData</code>(<var title="">format</var>, <var title="">data</var>)</dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-addElement">addElement</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">types</code></dt>
+
+   <dd>
+
+    <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>
+
+
    <dt><var title="">data</var> = <var title="">dataTransfer</var> . <code title="dom-DataTransfer-getData">getData</code>(<var title="">format</var>)</dt>
 
    <dd>
@@ -77272,27 +77288,31 @@
 
    </dd>
 
-   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-files">files</code></dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-setData">setData</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">setDragImage</code>(<var title="">element</var>, <var title="">x</var>, <var title="">y</var>)</dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-clearData">clearData</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">addElement</code>(<var title="">element</var>)</dt>
 
+   <dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-files">files</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>
 
@@ -77337,6 +77357,73 @@
   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 title="dom-DataTransfer-items"><code>items</code></dfn>
+  attribute must return a <code>DataTransferItems</code> object
+  associated with the <code>DataTransfer</code> object. The same
+  object must be returned each time.</p>
+
+  <p>The <dfn
+  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>DataTransfer</code> object is no longer
+   associated with a <span>drag data store</span>, abort these steps.
+   Nothing happens.</p></li>
+
+   <li><p>If the <span>drag data store</span>'s <span title="drag data
+   store mode">mode</span> is not in the <span
+   title="concept-dnd-rw">read/write mode</span>, abort these steps.
+   Nothing happens.</p></li>
+
+   <li><p>If the <var title="">element</var> argument is an
+   <code>img</code> element, then set the <span>drag data store
+   bitmap</span> to the element's image (at its intrinsic size);
+   otherwise, set the <span>drag data store bitmap</span> to an image
+   generated from the given element (the exact mechanism for doing so
+   is not currently specified).</p></li>
+
+   <li><p>Set the <span>drag data store hot spot coordinate</span> to
+   the given <var title="">x</var>, <var title="">y</var>
+   coordinate.</p></li>
+
+  </ol>
+
+  <p>The <dfn
+  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>DataTransfer</code> object is no longer
+   associated with a <span>drag data store</span>, abort these steps.
+   Nothing happens.</p></li>
+
+   <li><p>If the <span>drag data store</span>'s <span title="drag data
+   store mode">mode</span> is not in the <span
+   title="concept-dnd-rw">read/write mode</span>, abort these steps.
+   Nothing happens.</p></li>
+
+   <li><p>Add the given <var title="">element</var> to the element's
+   <span>drag data store elements list</span>.</p></li>
+
+  </ol>
+
+  <p class="note">The difference between <code
+  title="dom-DataTransfer-setDragImage">setDragImage()</code> and
+  <code title="dom-DataTransfer-addElement">addElement()</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 title="dom-DataTransfer-types"><code>types</code></dfn>
   attribute must return a <span>live</span> <code>DOMStringList</code>
   giving the strings that the following steps would produce. The same
@@ -77371,9 +77458,9 @@
 
   </ol>
 
-  <p>The <dfn
-  title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
-  method must run the following steps:</p>
+  <p>The <dfn title="dom-DataTransfer-getData"><code>getData(<var
+  title="">format</var>, <var title="">data</var>)</code></dfn> method
+  must run the following steps:</p>
 
   <ol>
 
@@ -77382,47 +77469,49 @@
    Nothing happens.</p></li>
 
    <li><p>If the <span>drag data store</span>'s <span title="drag data
-   store mode">mode</span> is not the <span
-   title="concept-dnd-rw">read/write mode</span>, abort these steps.
+   store mode">mode</span> is in the <span
+   title="concept-dnd-p">protected mode</span>, abort these steps.
    Nothing happens.</p></li>
 
-   <li><p>If the method was called with no arguments, remove each item
-   in the <span>drag data store item list</span> whose <span
-   title="the drag data item kind">kind</span> is <i>Plain Unicode
-   string</i>, and abort these steps.</p></li>
-
    <li><p>Let <var title="">format</var> be the first argument,
    <span>converted to ASCII lowercase</span>.</p></li>
 
-   <li>
+   <li><p>Let <var title="">convert-to-URL</var> be false.</p></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="">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>".</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.</p></li>
 
-   </li>
-
-   <li><p>Remove the item in the <span>drag data store item
+   <li><p>If there is no item in the <span>drag data store item
    list</span> whose <span title="the drag data item kind">kind</span>
    is <i>Plain Unicode string</i> and whose <span title="the drag data
    item type string">type string</span> is equal to <var
-   title="">format</var>, if there is one.</p></li>
+   title="">format</var>, return the empty string and abort these
+   steps.</p></li>
 
+   <li><p>Let <var title="">result</var> be the data of the item
+   in the <span>drag data store item list</span> whose <span
+   title="the drag data item kind">kind</span> is <i>Plain Unicode
+   string</i> and whose <span title="the drag data item type
+   string">type string</span> is equal to <var
+   title="">format</var>.</p></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></p></li>
+
+   <li><p>Return <var title="">result</var>.</p></li>
+
   </ol>
 
-  <p class="note">The <code
-  title="dom-DataTransfer-clearData">clearData()</code> method does
-  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 any files
-  were included in the drag).</p>
-
   <p>The <dfn title="dom-DataTransfer-setData"><code>setData(<var
   title="">format</var>, <var title="">data</var>)</code></dfn> method
   must run the following steps:</p>
@@ -77468,9 +77557,9 @@
 
   </ol>
 
-  <p>The <dfn title="dom-DataTransfer-getData"><code>getData(<var
-  title="">format</var>, <var title="">data</var>)</code></dfn> method
-  must run the following steps:</p>
+  <p>The <dfn
+  title="dom-DataTransfer-clearData"><code>clearData()</code></dfn>
+  method must run the following steps:</p>
 
   <ol>
 
@@ -77479,49 +77568,47 @@
    Nothing happens.</p></li>
 
    <li><p>If the <span>drag data store</span>'s <span title="drag data
-   store mode">mode</span> is in the <span
-   title="concept-dnd-p">protected mode</span>, abort these steps.
+   store mode">mode</span> is not the <span
+   title="concept-dnd-rw">read/write mode</span>, abort these steps.
    Nothing happens.</p></li>
 
+   <li><p>If the method was called with no arguments, remove each item
+   in the <span>drag data store item list</span> whose <span
+   title="the drag data item kind">kind</span> is <i>Plain Unicode
+   string</i>, and abort these steps.</p></li>
+
    <li><p>Let <var title="">format</var> be the first argument,
    <span>converted to ASCII lowercase</span>.</p></li>
 
-   <li><p>Let <var title="">convert-to-URL</var> be false.</p></li>
+   <li>
 
-   <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="">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.</p></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 <span>drag data store item
+   </li>
+
+   <li><p>Remove the item in the <span>drag data store item
    list</span> whose <span title="the drag data item kind">kind</span>
    is <i>Plain Unicode string</i> and whose <span title="the drag data
    item type string">type string</span> is equal to <var
-   title="">format</var>, return the empty string and abort these
-   steps.</p></li>
+   title="">format</var>, if there is one.</p></li>
 
-   <li><p>Let <var title="">result</var> be the data of the item
-   in the <span>drag data store item list</span> whose <span
-   title="the drag data item kind">kind</span> is <i>Plain Unicode
-   string</i> and whose <span title="the drag data item type
-   string">type string</span> is equal to <var
-   title="">format</var>.</p></li>
+  </ol>
 
-   <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></p></li>
+  <p class="note">The <code
+  title="dom-DataTransfer-clearData">clearData()</code> method does
+  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 any files
+  were included in the drag).</p>
 
-   <li><p>Return <var title="">result</var>.</p></li>
-
-  </ol>
-
   <p>The <dfn title="dom-DataTransfer-files"><code>files</code></dfn>
   attribute must return a <span>live</span> <code>FileList</code>
   sequence consisting of <code>File</code> objects representing the
@@ -77561,73 +77648,6 @@
   <p class="note">This version of the API does not expose the types of
   the files during the drag.</p>
 
-  <p>The <dfn title="dom-DataTransfer-items"><code>items</code></dfn>
-  attribute must return a <code>DataTransferItems</code> object
-  associated with the <code>DataTransfer</code> object. The same
-  object must be returned each time.</p>
-
-  <p>The <dfn
-  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>DataTransfer</code> object is no longer
-   associated with a <span>drag data store</span>, abort these steps.
-   Nothing happens.</p></li>
-
-   <li><p>If the <span>drag data store</span>'s <span title="drag data
-   store mode">mode</span> is not in the <span
-   title="concept-dnd-rw">read/write mode</span>, abort these steps.
-   Nothing happens.</p></li>
-
-   <li><p>If the <var title="">element</var> argument is an
-   <code>img</code> element, then set the <span>drag data store
-   bitmap</span> to the element's image (at its intrinsic size);
-   otherwise, set the <span>drag data store bitmap</span> to an image
-   generated from the given element (the exact mechanism for doing so
-   is not currently specified).</p></li>
-
-   <li><p>Set the <span>drag data store hot spot coordinate</span> to
-   the given <var title="">x</var>, <var title="">y</var>
-   coordinate.</p></li>
-
-  </ol>
-
-  <p>The <dfn
-  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>DataTransfer</code> object is no longer
-   associated with a <span>drag data store</span>, abort these steps.
-   Nothing happens.</p></li>
-
-   <li><p>If the <span>drag data store</span>'s <span title="drag data
-   store mode">mode</span> is not in the <span
-   title="concept-dnd-rw">read/write mode</span>, abort these steps.
-   Nothing happens.</p></li>
-
-   <li><p>Add the given <var title="">element</var> to the element's
-   <span>drag data store elements list</span>.</p></li>
-
-  </ol>
-
-  <p class="note">The difference between <code
-  title="dom-DataTransfer-setDragImage">setDragImage()</code> and
-  <code title="dom-DataTransfer-addElement">addElement()</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>
 
 




More information about the Commit-Watchers mailing list