DataTransferItemList

The DataTransferItemList object is a list of drag data items. During a drag operation, each drag event 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 No support 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 No support No support No support No support No support

[1]Partial support refers to not supporting .setDragImage [CanIUse.com]

Document Tags and Contributors

 Contributors to this page: rolfedh, lian79, AFBarstow
 Last updated by: rolfedh,