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

DataTransfer:dropEffect 属性

· 52CE 我爱测

`DataTransfer.dropEffect`** 属性控制在拖放操作中给用户的反馈(通常是视觉上的)。它会影响在拖动过程中光标的手势。例如,当用户在一个放置目标元素上悬停时,浏览器的光标可能会预示了将会发生什么操作。

HTML Drag and Drop API

DataTransfer.dropEffect 属性控制在拖放操作中给用户的反馈(通常是视觉上的)。它会影响在拖动过程中光标的手势。例如,当用户在一个放置目标元素上悬停时,浏览器的光标可能会预示了将会发生什么操作。

当 DataTransfer 被创建时,dropEffect 被设置为一个字符串。读取该值会返回它的当前值。设置该值时,若新值是下面列出的值中的一个,这个属性的值就会被设置为这个新的值,其他的值都会被忽略。

对于 dragenter 和 dragover 事件,dropEffect 会根据用户的请求的行为进行初始化。具体如何初始化和浏览器平台有关,但是通常来讲,用户可以通过按住修改键(如 alt 键)来修改预期行为。当我们期望得到一个指定的行为时而不是用户的请求行为时,可以通过 dragenter 和 dragover 事件的事件处理器处理修改 dropEffect 的值。

对于 drop 和 dragend 事件,dropEffect 会被设置为想要得到的值,即最后一次 dragenter 或 dragover 事件后 dropEffect 的值。例如,在一个 dragend 事件中,如果期望得到的 dropEffect 是“move”,那么被拖动的数据会从源中移除。

语法

dataTransfer.dropEffect;

值

一个代表拖动操作效果的字符串。可能的值有:

  • copy
    • : 在新位置生成源项的副本
  • move
    • : 将项目移动到新位置
  • link
    • : 在新位置建立源项目的链接
  • none
    • : 项目未能被放置。

将任何其他值赋给 dropEffect 都没有效果,此时只会保留旧值。

示例

下述示例演示了 dropEffect 和 DataTransfer.effectAllowed 属性的用法。

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(
    `dragStart:dropEffect = ${ev.dataTransfer.dropEffect};effectAllowed = ${ev.dataTransfer.effectAllowed}`,
  );

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

target.addEventListener("drop", (ev) => {
  console.log(
    `drop:dropEffect = ${ev.dataTransfer.dropEffect};effectAllowed = ${ev.dataTransfer.effectAllowed}`,
  );
  ev.preventDefault();

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

target.addEventListener("dragover", (ev) => {
  console.log(
    `dragOver:dropEffect = ${ev.dataTransfer.dropEffect};effectAllowed = ${ev.dataTransfer.effectAllowed}`,
  );
  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

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

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