kotlin-browser/web.data/DataTransferItemList

DataTransferItemList

open class DataTransferItemList : ArrayLike<DataTransferItem> , JsIterable<DataTransferItem> (source)

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.

MDN Reference

Properties

length

open override val length: Int

The read-only length property of the DataTransferItemList interface returns the number of items currently in the drag item list.

Functions

add

fun add(data: File): DataTransferItem?

fun add(data: String, type: String): DataTransferItem?

The DataTransferItemList.add() method creates a new DataTransferItem using the specified data and adds it to the drag data list. The item may be a File or a string of a given type. If the item is successfully added to the list, the newly-created DataTransferItem object is returned.

clear

fun clear()

The DataTransferItemList method clear() removes all DataTransferItem objects from the drag data items list, leaving the list empty.

get

open operator fun get(index: Int): DataTransferItem

open operator fun get(key: Symbol.iterator): () -> JsIterator<DataTransferItem>

remove

fun remove(index: Int)

The DataTransferItemList.remove() method removes the DataTransferItem at the specified index from the list. If the index is less than zero or greater than one less than the length of the list, the list will not be changed.