[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