跳到主要内容

DataTransferItem

2023年03月04日
柏拉文
越努力,越幸运

一、认识


DataTransferItem 描述了一个拖拽项。在一个拖拽操作中,每一个 drag event 都有一个 dataTransfer 属性,它包含一个存有拖拽数据的 list ,其中每一项都是一个 DataTransferItem

二、属性


2.1 DataTransferItem.kind

DataTransferItem.kind 是一个只读属性,它返回一个 DataTransferItem 用来表示拖拽项 (drag data item) 的类型: 一些文本或者一些文件。

语法

var itemKind = DataTransferItem.kind;

返回值

DOMString 用来表示拖拽项 (drag data item) 的类型. 它的值必须是以下值中的一个:

  • file: 拖拽项是一个文件

  • string: 拖拽项是一个普通的 Unicode 字符

2.2 DataTransferItem.type

DataTransferItem.type 返回代表拖动数据项的 DataTransferItem 对象的类型(格式)。 type 是一个 Unicode 字符串,通常由 MIME 给出,不过不需要 MIME 类型。

语法

dataItem.type;

返回值

一个代表拖动数据项类型的 DOMString

三、方法


3.1 DataTransferItem.getAsFile()

如果 DataTransferItem 是一个文件,那 DataTransferItem.getAsFile() 方法将返回拖拽项数据的 File 对象。如果拖拽项的数据不是一个文件,则返回 null.

语法

File = DataTransferItem.getAsFile();

返回值

如果拖拽项的对象是一个文件,则返回 File 对象; 否则返回 null .

3.2 DataTransferItem.getAsString()

DataTransferItem.getAsString()DataTransferItem 对象的 kind 属性是一个普通 Unicode 字符串时,该方法会用 DataTransferItem 对象的 kind 属性作为入参来执行传入的回调函数.

语法

dataTransferItem.getAsString(callback);

3.3 DataTransferItem.webkitGetAsEntry()