[prev in list] [next in list] [prev in thread] [next in thread]
List: html5-commit-watchers
Subject: [html5] r5790 - [giow] (0) Fix the IDL for DataTransfer,
From: whatwg () whatwg ! org
Date: 2011-01-20 20:30:51
Message-ID: 20110120203051.F42078058157 () ps20323 ! dreamhostps ! com
[Download RAW message or body]
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>
_______________________________________________
Commit-Watchers mailing list
Commit-Watchers@lists.whatwg.org
http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic