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);