大网数据广告活动
Web 标准与前端开发

DataTransferItem

· 52CE 我爱测

`DataTransferItem`** 对象表示一个拖动数据项。在一个*拖动操作*中,每一个 DragEvent 都有包含存有拖动数据项的DataTransferItemList 的 DragEvent.dataTransfer 属性,其中每一项都是一个 `DataTransferItem` 对象。

HTML Drag and Drop API

DataTransferItem 对象表示一个拖动数据项。在一个拖动操作中,每一个 DragEvent 都有包含存有拖动数据项的DataTransferItemList 的 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()
    • : 返回一个 Promise,其在拖动项为文件时将兑现为 FileSystemFileHandle,而在拖动项为目录时将兑现为 FileSystemDirectoryHandle。
  • DataTransferItem.getAsString()
    • : 使用拖动数据项的字符串作为参数执行指定回调函数。
  • DataTransferItem.webkitGetAsEntry()
    • : 返回一个基于 FileSystemEntry 的对象来表示文件系统中选中的项目。这通常是一个 FileSystemFileEntry 或 FileSystemDirectoryEntry 对象。

示例

这个接口所有的属性和方法都有自己的参考页,请到各自的参考页中查看用法示例。

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。