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

DataTransfer:items 属性

· 52CE 我爱测

DataTransfer 接口的 `items` 只读属性返回表示拖拽操作中的DataTransferItem的DataTransferItemList,每个被拖拽的对象对应一个列表项。当操作没有项目时列表为空。

HTML Drag and Drop API

DataTransfer 接口的 items 只读属性返回表示拖拽操作中的DataTransferItem的DataTransferItemList,每个被拖拽的对象对应一个列表项。当操作没有项目时列表为空。

取值

包含表示拖拽操作中被拖拽的项的 DataTransferItem 对象的 DataTransferItemList 对象,每个被拖拽的对象对应一个列表项。如果拖拽操作中没有数据,则列表为空。

示例

记录被拖拽的项目

本示例使用 items 来记录被拖拽项目的信息。

HTML

<ul>
  <li id="source1" draggable="true">将项目一拖拽到可放置区域</li>
  <li id="source2" draggable="true">将项目二拖拽到可放置区域</li>
</ul>
<div id="target">可放置区域</div>

<button id="reset">重置</button>

CSS

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

#target {
  border: 1px solid black;
}

JavaScript

function dragstartHandler(ev) {
  console.log(`dragstart: target.id = ${ev.target.id}`);
  // 将此元素的 id 添加到拖拽负载中,以便放置处理器知道将哪个元素添加到树中
  ev.dataTransfer.setData("text/plain", ev.target.id);
  ev.dataTransfer.effectAllowed = "move";
}

function dropHandler(ev) {
  ev.preventDefault();
  // 获取目标的 id 并将移动的元素添加到目标的 DOM 中
  const data = ev.dataTransfer.getData("text");
  ev.target.appendChild(document.getElementById(data));
  // 打印每个项目的“kind”和“type”
  if (ev.dataTransfer.items) {
    for (const item of ev.dataTransfer.items) {
      console.log(`kind = ${item.kind}, type = ${item.type}`);
    }
  }
}

function dragoverHandler(ev) {
  ev.preventDefault();
  // 设置 dropEffect 为 move
  ev.dataTransfer.dropEffect = "move";
}

const source1 = document.querySelector("#source1");
const source2 = document.querySelector("#source2");
const target = document.querySelector("#target");

source1.addEventListener("dragstart", dragstartHandler);
source2.addEventListener("dragstart", dragstartHandler);
target.addEventListener("dragover", dragoverHandler);
target.addEventListener("drop", dropHandler);

const reset = document.querySelector("#reset");
reset.addEventListener("click", () => document.location.reload());

结果

记录被拖拽的项目

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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