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.lengthRead only- An
unsigned longthat is the number of drag items in the list.
Methods
DataTransferItemList.add()- Adds an item (either a
Fileobject or astring) to the drag item list and returns aDataTransferItemobject 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
DataTransferItemat 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. |
Recommendation | Not included in W3C HTML5 Recommendation |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| Basic support | 4 | (Yes) | 50 (50) | No support | 12 | No support |
| Feature | Android | Android Webview | Chrome for Android | Edge | 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]