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 a string) to the drag item list and returns a DataTransferItem 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

API DataTransferItemList drag and drop HTML DOM HTML Drag and Drop API Interface Reference