DataTransferItem

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() 实验性

如果拖动的项目是文件,则返回FileSystemFileHandle,如果拖动的项目是目录,则返回FileSystemDirectoryHandle

DataTransferItem.getAsString()

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

DataTransferItem.webkitGetAsEntry()

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

示例

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

规范

规范
HTML 标准
# the-datatransferitem-interface

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。