DataTransferItem
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()
实验性-
如果拖动的项目是文件,则返回
FileSystemFileHandle
,如果拖动的项目是目录,则返回FileSystemDirectoryHandle
。 DataTransferItem.getAsString()
-
使用拖动数据项字符串作为其参数调用指定的回调函数。
DataTransferItem.webkitGetAsEntry()
-
返回一个基于
FileSystemEntry
的对象,表示所选文件在其文件系统中的条目。这通常是FileSystemFileEntry
或FileSystemDirectoryEntry
对象。
示例
此接口的所有方法和属性都有自己的参考页面,并且每个参考页面都有其用法的示例。
规范
规范 |
---|
HTML 标准 # the-datatransferitem-interface |
浏览器兼容性
BCD 表格仅在启用 JavaScript 的浏览器中加载。