DataTransferItem
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2016年11月.
* Some parts of this feature may have varying levels of support.
DataTransferItem 对象表示一个拖动数据项。在一个拖动操作中,每一个 DragEvent 都有包含存有拖动数据项的列表 的 dataTransfer 属性,其中每一项都是一个 DataTransferItem 对象。
DataTransferItem 主要旨在服务 HTML 拖放 API,它在 HTML 拖放一节中得到定义,但也用于其他 API,如 ClipboardEvent.clipboardData 和 InputEvent.dataTransfer。DataTransferItem 的文档将主要讨论拖放操作中该对象的使用方式。你应该参考相应 API 的文档以了解在其他上下文环境中 DataTransferItem 的使用方式。
这个接口没有构造函数。
实例属性
DataTransferItem.kind只读-
拖动数据项的种类,可以是
string或file。 DataTransferItem.type只读-
拖动数据项的类型,通常是 MIME 类型。
实例方法
DataTransferItem.getAsFile()-
返回一个关联拖动数据项的
File对象(当拖动项不是一个文件时返回 null)。 DataTransferItem.getAsFileSystemHandle()实验性-
返回一个
Promise,其在拖动项为文件时将兑现为FileSystemFileHandle,而在拖动项为目录时将兑现为FileSystemDirectoryHandle。 DataTransferItem.getAsString()-
使用拖动数据项的字符串作为参数执行指定回调函数。
DataTransferItem.webkitGetAsEntry()-
返回一个基于
FileSystemEntry的对象来表示文件系统中选中的项目。这通常是一个FileSystemFileEntry或FileSystemDirectoryEntry对象。
示例
这个接口所有的属性和方法都有自己的参考页,请到各自的参考页中查看用法示例。
规范
| Specification |
|---|
| HTML> # the-datatransferitem-interface> |