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

DataTransferItemList

· 52CE 我爱测

`DataTransferItemList`** 对象是一个 DataTransferItem 对象的列表,表示正在被拖拽的项。在*拖拽操作*期间,每个 DragEvent 都有一个 DragEvent.dataTransfer 属性,该属性是一个 `DataTransferItemList`。

HTML Drag and Drop API

DataTransferItemList 对象是一个 DataTransferItem 对象的列表,表示正在被拖拽的项。在拖拽操作期间,每个 DragEvent 都有一个 DragEvent.dataTransfer 属性,该属性是一个 DataTransferItemList。

可以使用方括号表示法 [] 访问各个项。

DataTransferItemList 最初是为 HTML 拖放 API 设计的,并且仍然在 HTML 拖放部分中定义,但现在也被其他 API 使用,例如 ClipboardEvent.clipboardData 和 InputEvent.dataTransfer。DataTransferItemList 的文档将主要讨论其在拖放操作中的使用,而在其他场景中使用 DataTransferItemList 时,你应参考相应 API 的文档。

该接口没有构造函数。

实例属性

  • DataTransferItemList.length
    • : unsigned long 类型的值,表示列表中拖拽项的数量。

实例方法

  • DataTransferItemList.add()
    • : 向拖拽项列表中添加一个项(可以是 File 对象或字符串),并返回新项的 DataTransferItem 对象。
  • DataTransferItemList.remove()
    • : 从列表中移除指定索引处的拖拽项。
  • DataTransferItemList.clear()
    • : 从列表中移除所有拖拽项。

示例

此示例展示了如何使用拖放。

HTML

<div>
  <p id="source" draggable="true">
    选择该元素,拖动它到可放置区域并释放选择以移动元素。
  </p>
</div>
<div id="target">可放置区域</div>

CSS

div {
  margin: 0em;
  padding: 2em;
}

#source {
  color: blue;
  border: 1px solid black;
}

#target {
  border: 1px solid black;
}

JavaScript

const source = document.getElementById("source");
const target = document.getElementById("target");

source.addEventListener("dragstart", (ev) => {
  console.log("拖拽开始");

  // 添加元素的 ID 到拖拽负荷中,以便于放置处理器清楚要将什么元素添加到其树中
  const dataList = ev.dataTransfer.items;
  dataList.add(ev.target.id, "text/plain");

  // 添加其他项目作为拖拽负荷
  dataList.add("<p>段落……</p>", "text/html");
  dataList.add("http://www.example.org", "text/uri-list");
});

source.addEventListener("dragend", (ev) => {
  console.log("拖拽结束");
  const dataList = ev.dataTransfer.items;

  // 清除剩余的拖拽数据
  dataList.clear();
});

target.addEventListener("drop", (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
      item.getAsString((s) => {
        console.log(`……放置:HTML = ${s}`);
      });
    } else if (item.kind === "string" && item.type.match(/^text\/uri-list/)) {
      // 拖动数据项为 URI
      item.getAsString((s) => {
        console.log(`……放置:URI = ${s}`);
      });
    }
  }
});

target.addEventListener("dragover", (ev) => {
  console.log("拖拽经过");
  ev.preventDefault();

  // 设置 dropEffect 为 move
  ev.dataTransfer.dropEffect = "move";
});

结果

示例

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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