当前位置：文江博客知识库 en-US 文档 Web API DataTransferItem

DataTransferItem - Web APIs 编辑

The DataTransferItem object represents one drag data item. During a drag operation, each drag event has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object.

This interface has no constructor.

Properties

DataTransferItem.kind Read only: The kind of drag data item, string or file.
DataTransferItem.type Read only: The drag data item's type, typically a MIME type.

Methods

DataTransferItem.getAsFile(): Returns the File object associated with the drag data item (or null if the drag item is not a file).
DataTransferItem.getAsFileSystemHandle(): Returns a FileSystemFileHandle if the dragged item is a file, or a FileSystemDirectoryHandle if the dragged item is a directory.
DataTransferItem.getAsString(): Invokes the specified callback with the drag data item string as its argument.
DataTransferItem.webkitGetAsEntry(): Returns an object based on FileSystemEntry representing the selected file's entry in its file system. This will generally be either a FileSystemFileEntry or FileSystemDirectoryEntry object.

Example

All of this interface's methods and properties have their own reference page, and each reference page has an example of its usage.

Specifications

Specification	Status	Comment
HTML Living Standard The definition of 'DataTransferItem' in that specification.	Living Standard	Initial definition.
HTML 5.1 The definition of 'DataTransferItem' in that specification.	Recommendation	W3C snapshot of WHATWG
File and Directory Entries API The definition of 'DataTransferItem.webkitGetAsEntry()' in that specification.	Draft	Definition of `webkitGetAsEntry()` as part of the File and Directory Entries API.