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

DataTransferItem:getAsFile() 方法

· 52CE 我爱测

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

HTML Drag and Drop API

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

语法

getAsFile()

参数

无。

返回值

在拖拽数据项是一个文件时返回 File 对象,否则返回 null .

示例

下述示例展示了 getAsFile() 方法在 HTMLElement/drop_event 事件处理器中的用法。

function dropHandler(ev) {
  console.log("放置操作");
  ev.preventDefault();
  for (const item of ev.dataTransfer.items) {
    if (item.kind === "string" && item.type.match("^text/plain")) {
      // 项目是目标节点
      item.getAsString((s) => {
        ev.target.appendChild(document.getElementById(s));
      });
    } else if (item.kind === "string" && item.type.match("^text/html")) {
      // 拖拽数据项是 HTML
      console.log("放置了 HTML");
    } else if (item.kind === "string" && item.type.match("^text/uri-list")) {
      // 拖拽数据项是 URI
      console.log("放置了 URI");
    } else if (item.kind === "file" && item.type.match("^image/")) {
      // 拖拽数据项是图像文件
      const f = item.getAsFile();
      console.log("放置了文件");
    }
  }
}

规范

浏览器兼容性

参见

  • DataTransfer.files

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

资料来源与适用范围

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

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

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