DataTransferItem - 表示一个拖动数据项
DataTransferItem
对象表示一个拖动数据项。在_拖动操作_期间,每个 drag event
都有 dataTransfer
属性,其中包含拖动数据项的 list
。列表中的每个项目都是一个 DataTransferItem
对象。
该接口没有构造函数。
属性
DataTransferItem.kind
只读
拖动数据项的_种类_, string
或 file
。
DataTransferItem.type
只读
拖动数据项的类型,通常是 MIME 类型。
方法
DataTransferItem.getAsFile()
返回与拖动数据项关联的 File
对象(如果拖动项不是文件,则返回 null
)。
DataTransferItem.getAsString()
使用拖动数据项字符串作为参数调用指定的回调。
DataTransferItem.webkitGetAsEntry()
返回基于 FileSystemEntry
的对象,表示其文件系统中所选文件的条目。这通常是 FileSystemFileEntry
或 FileSystemDirectoryEntry
对象。
规范
规范 | 状态 | 备注 |
---|---|---|
HTML Living Standard DataTransferItem 的定义 |
现行的标准 | 初始定义。 |
HTML 5.1 DataTransferItem 的定义 |
推荐 | WHATWG 的 W3C 快照 |
File and Directory Entries API DataTransferItem.webkitGetAsEntry() 的定义 |
编者的草案 |
webkitGetAsEntry() 的定义,作为文件和目录条目 API的一部分。 |
桌面浏览器兼容性
特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
基础支持 | 4 | 支持 | 50 | 不支持 | 12 | 不支持 |
getAsFile |
4 | 支持 | 50 | 不支持 | 12 | 不支持 |
getAsString |
4 | 支持 | 50 | 不支持 | 12 | 不支持 |
kind |
4 | 支持 | 50 | 不支持 | 12 | 不支持 |
type |
4 | 支持 | 50 | 不支持 | 12 | 不支持 |
webkitGetAsEntry |
13 | 支持 | 50 | 不支持 | 不支持 | 不支持 |
移动浏览器兼容性
特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
基础支持 | 支持 | 支持 | 未知 | 50 | 未知 | 不支持 | 不支持 |
getAsFile |
支持 | 支持 | 未知 | 50 | 未知 | 不支持 | 不支持 |
getAsString |
支持 | 支持 | 未知 | 50 | 未知 | 不支持 | 不支持 |
kind |
支持 | 支持 | 未知 | 50 | 未知 | 不支持 | 不支持 |
type |
支持 | 支持 | 未知 | 50 | 未知 | 不支持 | 不支持 |
webkitGetAsEntry |
不支持 | 支持 | 不支持 | 50 | 未知 | 不支持 | 不支持 |