[html5] r7315 - [giow] (0) Drop addElement() since Gecko doesn't implement it right and nobody i [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Sep 5 09:34:51 PDT 2012


Author: ianh
Date: 2012-09-05 09:34:50 -0700 (Wed, 05 Sep 2012)
New Revision: 7315

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Drop addElement() since Gecko doesn't implement it right and nobody implements it at all.
Affected topics: HTML

Modified: complete.html
===================================================================
--- complete.html	2012-09-04 23:09:29 UTC (rev 7314)
+++ complete.html	2012-09-05 16:34:50 UTC (rev 7315)
@@ -246,7 +246,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><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 4 September 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 5 September 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -79029,9 +79029,6 @@
     <ul><li>User-agent-defined default feedback information, known as the
      <dfn id=drag-data-store-default-feedback>drag data store default feedback</dfn>.</li>
 
-     <li>A list of zero or more elements known as the <dfn id=drag-data-store-elements-list>drag data
-     store elements list</dfn>.</li>
-
      <li>Optionally, a bitmap image and the coordinate of a point
      within that image, known as the <dfn id=drag-data-store-bitmap>drag data store bitmap</dfn>
      and <dfn id=drag-data-store-hot-spot-coordinate>drag data store hot spot coordinate</dfn>.</li>
@@ -79082,10 +79079,9 @@
   </ul><p>When a <a href=#drag-data-store>drag data store</a> is <dfn id=create-a-drag-data-store title="create a drag
   data store">created</dfn>, it must be initialized such that its
   <a href=#drag-data-store-item-list>drag data store item list</a> is empty, it has no
-  <a href=#drag-data-store-default-feedback>drag data store default feedback</a>, its <a href=#drag-data-store-elements-list>drag data
-  store elements list</a> is empty, it has no <a href=#drag-data-store-bitmap>drag data store
-  bitmap</a> / <a href=#drag-data-store-hot-spot-coordinate>drag data store hot spot coordinate</a>,
-  its <a href=#drag-data-store-mode>drag data store mode</a> is <a href=#concept-dnd-p title=concept-dnd-p>protected mode</a>, and its <a href=#drag-data-store-allowed-effects-state>drag data
+  <a href=#drag-data-store-default-feedback>drag data store default feedback</a>, it has no <a href=#drag-data-store-bitmap>drag
+  data store bitmap</a> and <a href=#drag-data-store-hot-spot-coordinate>drag data store hot spot
+  coordinate</a>, its <a href=#drag-data-store-mode>drag data store mode</a> is <a href=#concept-dnd-p title=concept-dnd-p>protected mode</a>, and its <a href=#drag-data-store-allowed-effects-state>drag data
   store allowed effects state</a> is the string "<code title="">uninitialized</code>".</p>
 
 
@@ -79102,7 +79098,6 @@
   readonly attribute <a href=#datatransferitemlist>DataTransferItemList</a> <a href=#dom-datatransfer-items title=dom-DataTransfer-items>items</a>;
 
   void <a href=#dom-datatransfer-setdragimage title=dom-DataTransfer-setDragImage>setDragImage</a>(Element image, long x, long y);
-  void <a href=#dom-datatransfer-addelement title=dom-DataTransfer-addElement>addElement</a>(Element element);
 
   /* old interface */
   readonly attribute DOMString[] <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
@@ -79158,17 +79153,8 @@
     <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-addElement><a href=#dom-datatransfer-addelement>addElement</a></code>(<var title="">element</var>)</dt>
-
-   <dd>
-
-    <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>
@@ -79275,30 +79261,7 @@
    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>
+  </ol><p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
   attribute must return a <a href=#live>live</a> <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array giving the
   strings that the following steps would produce. The same object must
   be returned each time.</p>
@@ -80255,21 +80218,14 @@
 
    <li>
 
-    <p>If it is an element that is being dragged, then set the
-    <a href=#drag-data-store-elements-list>drag data store elements list</a> to contain just the
-    <a href=#source-node>source node</a>.</p>
-
-    <p>Otherwise, update the <a href=#drag-data-store-default-feedback>drag data store default
-    feedback</a> as appropriate for the user agent (if the user is
-    dragging the selection, then the selection would likely be the
-    basis for this feedback; if the drag began outside the user agent,
+    <p>Update the <a href=#drag-data-store-default-feedback>drag data store default feedback</a> as
+    appropriate for the user agent (if the user is dragging the
+    selection, then the selection would likely be the basis for this
+    feedback; if the user is dragging an element, then that element's
+    rendering would be used; if the drag began outside the user agent,
     then the platform conventions for determining the drag feedback
     should be used).</p>
 
-    <p class=note>Script can use the <code title=dom-DataTransfer-addElement><a href=#dom-datatransfer-addelement>addElement()</a></code> method to
-    add further elements to the list of what is being dragged. (This
-    list is only used for rendering the drag feedback.)</p>
-
    </li>
 
    <li>
@@ -80305,9 +80261,6 @@
      pixels from the left side and from the top side of the image
      respectively. <a href=#refsCSS>[CSS]</a></li>
 
-     <li>The elements in the <a href=#drag-data-store-elements-list>drag data store elements
-     list</a>, if any.</li>
-
      <li>The <a href=#drag-data-store-default-feedback>drag data store default feedback</a>.</li>
 
     </ol></li>

Modified: index
===================================================================
--- index	2012-09-04 23:09:29 UTC (rev 7314)
+++ index	2012-09-05 16:34:50 UTC (rev 7315)
@@ -246,7 +246,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><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 4 September 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 5 September 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -79029,9 +79029,6 @@
     <ul><li>User-agent-defined default feedback information, known as the
      <dfn id=drag-data-store-default-feedback>drag data store default feedback</dfn>.</li>
 
-     <li>A list of zero or more elements known as the <dfn id=drag-data-store-elements-list>drag data
-     store elements list</dfn>.</li>
-
      <li>Optionally, a bitmap image and the coordinate of a point
      within that image, known as the <dfn id=drag-data-store-bitmap>drag data store bitmap</dfn>
      and <dfn id=drag-data-store-hot-spot-coordinate>drag data store hot spot coordinate</dfn>.</li>
@@ -79082,10 +79079,9 @@
   </ul><p>When a <a href=#drag-data-store>drag data store</a> is <dfn id=create-a-drag-data-store title="create a drag
   data store">created</dfn>, it must be initialized such that its
   <a href=#drag-data-store-item-list>drag data store item list</a> is empty, it has no
-  <a href=#drag-data-store-default-feedback>drag data store default feedback</a>, its <a href=#drag-data-store-elements-list>drag data
-  store elements list</a> is empty, it has no <a href=#drag-data-store-bitmap>drag data store
-  bitmap</a> / <a href=#drag-data-store-hot-spot-coordinate>drag data store hot spot coordinate</a>,
-  its <a href=#drag-data-store-mode>drag data store mode</a> is <a href=#concept-dnd-p title=concept-dnd-p>protected mode</a>, and its <a href=#drag-data-store-allowed-effects-state>drag data
+  <a href=#drag-data-store-default-feedback>drag data store default feedback</a>, it has no <a href=#drag-data-store-bitmap>drag
+  data store bitmap</a> and <a href=#drag-data-store-hot-spot-coordinate>drag data store hot spot
+  coordinate</a>, its <a href=#drag-data-store-mode>drag data store mode</a> is <a href=#concept-dnd-p title=concept-dnd-p>protected mode</a>, and its <a href=#drag-data-store-allowed-effects-state>drag data
   store allowed effects state</a> is the string "<code title="">uninitialized</code>".</p>
 
 
@@ -79102,7 +79098,6 @@
   readonly attribute <a href=#datatransferitemlist>DataTransferItemList</a> <a href=#dom-datatransfer-items title=dom-DataTransfer-items>items</a>;
 
   void <a href=#dom-datatransfer-setdragimage title=dom-DataTransfer-setDragImage>setDragImage</a>(Element image, long x, long y);
-  void <a href=#dom-datatransfer-addelement title=dom-DataTransfer-addElement>addElement</a>(Element element);
 
   /* old interface */
   readonly attribute DOMString[] <a href=#dom-datatransfer-types title=dom-DataTransfer-types>types</a>;
@@ -79158,17 +79153,8 @@
     <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-addElement><a href=#dom-datatransfer-addelement>addElement</a></code>(<var title="">element</var>)</dt>
-
-   <dd>
-
-    <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>
@@ -79275,30 +79261,7 @@
    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>
+  </ol><p>The <dfn id=dom-datatransfer-types title=dom-DataTransfer-types><code>types</code></dfn>
   attribute must return a <a href=#live>live</a> <a href=#dfn-read-only-array title=dfn-read-only-array>read only</a> array giving the
   strings that the following steps would produce. The same object must
   be returned each time.</p>
@@ -80255,21 +80218,14 @@
 
    <li>
 
-    <p>If it is an element that is being dragged, then set the
-    <a href=#drag-data-store-elements-list>drag data store elements list</a> to contain just the
-    <a href=#source-node>source node</a>.</p>
-
-    <p>Otherwise, update the <a href=#drag-data-store-default-feedback>drag data store default
-    feedback</a> as appropriate for the user agent (if the user is
-    dragging the selection, then the selection would likely be the
-    basis for this feedback; if the drag began outside the user agent,
+    <p>Update the <a href=#drag-data-store-default-feedback>drag data store default feedback</a> as
+    appropriate for the user agent (if the user is dragging the
+    selection, then the selection would likely be the basis for this
+    feedback; if the user is dragging an element, then that element's
+    rendering would be used; if the drag began outside the user agent,
     then the platform conventions for determining the drag feedback
     should be used).</p>
 
-    <p class=note>Script can use the <code title=dom-DataTransfer-addElement><a href=#dom-datatransfer-addelement>addElement()</a></code> method to
-    add further elements to the list of what is being dragged. (This
-    list is only used for rendering the drag feedback.)</p>
-
    </li>
 
    <li>
@@ -80305,9 +80261,6 @@
      pixels from the left side and from the top side of the image
      respectively. <a href=#refsCSS>[CSS]</a></li>
 
-     <li>The elements in the <a href=#drag-data-store-elements-list>drag data store elements
-     list</a>, if any.</li>
-
      <li>The <a href=#drag-data-store-default-feedback>drag data store default feedback</a>.</li>
 
     </ol></li>

Modified: source
===================================================================
--- source	2012-09-04 23:09:29 UTC (rev 7314)
+++ source	2012-09-05 16:34:50 UTC (rev 7315)
@@ -92326,9 +92326,6 @@
      <li>User-agent-defined default feedback information, known as the
      <dfn>drag data store default feedback</dfn>.</li>
 
-     <li>A list of zero or more elements known as the <dfn>drag data
-     store elements list</dfn>.</li>
-
      <li>Optionally, a bitmap image and the coordinate of a point
      within that image, known as the <dfn>drag data store bitmap</dfn>
      and <dfn>drag data store hot spot coordinate</dfn>.</li>
@@ -92387,10 +92384,9 @@
   <p>When a <span>drag data store</span> is <dfn title="create a drag
   data store">created</dfn>, it must be initialized such that its
   <span>drag data store item list</span> is empty, it has no
-  <span>drag data store default feedback</span>, its <span>drag data
-  store elements list</span> is empty, it has no <span>drag data store
-  bitmap</span> / <span>drag data store hot spot coordinate</span>,
-  its <span>drag data store mode</span> is <span
+  <span>drag data store default feedback</span>, it has no <span>drag
+  data store bitmap</span> and <span>drag data store hot spot
+  coordinate</span>, its <span>drag data store mode</span> is <span
   title="concept-dnd-p">protected mode</span>, and its <span>drag data
   store allowed effects state</span> is the string "<code
   title="">uninitialized</code>".</p>
@@ -92409,7 +92405,6 @@
   readonly attribute <span>DataTransferItemList</span> <span title="dom-DataTransfer-items">items</span>;
 
   void <span title="dom-DataTransfer-setDragImage">setDragImage</span>(Element image, long x, long y);
-  void <span title="dom-DataTransfer-addElement">addElement</span>(Element element);
 
   /* old interface */
   readonly attribute DOMString[] <span title="dom-DataTransfer-types">types</span>;
@@ -92474,17 +92469,8 @@
     <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-addElement">addElement</code>(<var title="">element</var>)</dt>
-
-   <dd>
-
-    <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>
@@ -92612,38 +92598,6 @@
 
   </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> <span
   title="dfn-read-only-array">read only</span> array giving the
@@ -93806,22 +93760,14 @@
 
    <li>
 
-    <p>If it is an element that is being dragged, then set the
-    <span>drag data store elements list</span> to contain just the
-    <span>source node</span>.</p>
-
-    <p>Otherwise, update the <span>drag data store default
-    feedback</span> as appropriate for the user agent (if the user is
-    dragging the selection, then the selection would likely be the
-    basis for this feedback; if the drag began outside the user agent,
+    <p>Update the <span>drag data store default feedback</span> as
+    appropriate for the user agent (if the user is dragging the
+    selection, then the selection would likely be the basis for this
+    feedback; if the user is dragging an element, then that element's
+    rendering would be used; if the drag began outside the user agent,
     then the platform conventions for determining the drag feedback
     should be used).</p>
 
-    <p class="note">Script can use the <code
-    title="dom-DataTransfer-addElement">addElement()</code> method to
-    add further elements to the list of what is being dragged. (This
-    list is only used for rendering the drag feedback.)</p>
-
    </li>
 
    <li>
@@ -93860,9 +93806,6 @@
      pixels from the left side and from the top side of the image
      respectively. <a href="#refsCSS">[CSS]</a></li>
 
-     <li>The elements in the <span>drag data store elements
-     list</span>, if any.</li>
-
      <li>The <span>drag data store default feedback</span>.</li>
 
     </ol>




More information about the Commit-Watchers mailing list