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

DataTransfer:types 属性

· 52CE 我爱测

`DataTransfer.types`** 只读属性返回在 DataTransfer.items 中存在的可用类型。

HTML Drag and Drop API

DataTransfer.types 只读属性返回在 DataTransfer.items 中存在的可用类型。

值

数据格式的数组。每种格式都是通常为 MIME 类型的字符串,如 text/plain 或 text/html。如果拖拽操作不包含数据,则此列表将为空。如果拖拽操作中包含任何文件,则其中一个类型将是 Files。

示例

下述示例展示了 types 和 DataTransfer.items 属性的具体使用方式:

<ul>
  <li id="i1" draggable="true">将项目一拖拽到可放置区域</li>
  <li id="i2" draggable="true">将项目二拖拽到可放置区域</li>
</ul>
<div id="target">可放置区域</div>
<pre id="output"></pre>
div {
  margin: 0em;
  padding: 2em;
}
#target {
  border: 1px solid black;
}
const output = document.getElementById("output");
function log(msg) {
  output.textContent += `${msg}\n`;
}

document.querySelectorAll("li").forEach((item) => {
  item.addEventListener("dragstart", dragstart_handler);
});

function dragstart_handler(ev) {
  log(`拖拽开始:target.id = ${ev.target.id}`);

  // 将该元素的 id 添加到拖拽负载中,以便放置事件的处理器能分清要将哪个元素添加到树中
  ev.dataTransfer.setData("text/plain", ev.target.id);
  ev.dataTransfer.effectAllowed = "move";
}

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

target.addEventListener("drop", (ev) => {
  log(`drop:target.id = ${ev.target.id}`);
  ev.preventDefault();

  // 获取目标的 id 并将移动的元素添加到目标的 DOM 中
  const data = ev.dataTransfer.getData("text");
  ev.target.appendChild(document.getElementById(data));

  // 打印各格式类型
  for (let i = 0; i < ev.dataTransfer.types.length; i++) {
    log(`… types[${i}] = ${ev.dataTransfer.types[i]}`);
  }

  // 打印各项的“kind”和“type”
  for (let i = 0; i < ev.dataTransfer.items.length; i++) {
    log(
      `… items[${i}].kind = ${ev.dataTransfer.items[i].kind};type = ${ev.dataTransfer.items[i].type}`,
    );
  }
});

target.addEventListener("dragover", (ev) => {
  ev.preventDefault();
  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

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

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