DataTransferItem

Baseline 广泛可用 *

此功能已得到良好确立,并在许多设备和浏览器版本中都可使用。自 ⁨2016 年 11 月⁩以来,它已在所有浏览器中可用。

* 此特性的某些部分可能存在不同级别的支持。

DataTransferItem 对象代表一个拖放的数据项。在拖放操作期间,每个 DragEvent 都有一个 dataTransfer 属性,其中包含一个拖放数据项的列表。列表中的每一项都是一个 DataTransferItem 对象。

DataTransferItem 最初是为 HTML 拖放 API 设计的,并且仍然在 HTML 拖放部分进行规范说明,但现在也被其他 API 使用,例如 ClipboardEvent.clipboardDataInputEvent.dataTransferDataTransferItem 的文档主要讨论其在拖放操作中的用法,您应该参考其他 API 的文档以了解 DataTransferItem 在这些上下文中的用法。

此接口没有构造函数。

实例属性

DataTransferItem.kind 只读

拖放数据项的类型,为 stringfile

DataTransferItem.type 只读

拖放数据项的类型,通常是 MIME 类型。

实例方法

DataTransferItem.getAsFile()

返回与拖放数据项关联的 File 对象(如果拖放项不是文件,则返回 null)。

DataTransferItem.getAsFileSystemHandle() 实验性

返回一个 Promise,如果拖放项是文件,则解析为 FileSystemFileHandle;如果拖放项是目录,则解析为 FileSystemDirectoryHandle

DataTransferItem.getAsString()

使用指定的字符串作为拖放数据项的参数调用该回调函数。

DataTransferItem.webkitGetAsEntry()

返回一个基于 FileSystemEntry 的对象,表示所选文件在其文件系统中的条目。这通常是 FileSystemFileEntryFileSystemDirectoryEntry 对象。

示例

此接口的所有方法和属性都有自己的参考页面,并且每个参考页面都有使用示例。

规范

规范
HTML
# the-datatransferitem-interface

浏览器兼容性