DataTransferItemList
The DataTransferItemList
object is a list of DataTransferItem
objects representing items being dragged. During a drag operation, each DragEvent
has a dataTransfer
property and that property is a DataTransferItemList
.
This interface has no constructor.
Properties
DataTransferItemList.length
Read only- An
unsigned long
that is the number of drag items in the list.
Methods
DataTransferItemList.add()
- Adds an item (either a
File
object or astring
) to the drag item list and returns aDataTransferItem
object for the new item. DataTransferItemList.remove()
- Removes the drag item from the list at the given index.
DataTransferItemList.clear()
- Removes all of the drag items from the list.
DataTransferItemList.DataTransferItem()
- Getter that returns a
DataTransferItem
at the given index.
Example
Each of this interface's methods and properties has a reference page, and each reference page has an example of its usage.
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard The definition of 'DataTransferItemList' in that specification. |
Living Standard | |
HTML5.1 The definition of 'DataTransferItemList' in that specification. |
Working Draft | Not included in W3C HTML5 Recommendation |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
---|---|---|---|---|---|
Basic support | 4 | 50 (50) | No support | 12 | No support |
Feature | Android | Android Webview | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|---|
Basic support | No support | No support | No support | 50.0 (50) | No support | No support | No support | No support |
[1]
Partial support refers to not supporting .setDragImage [CanIUse.com]
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/api/datatransferitemlist