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 | 未知 | 不支持 | 不支持 |