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

HTMLElement:dragover 事件

· 52CE 我爱测

`dragover` 事件在可拖动的元素或者被选择的文本被拖进一个有效的放置目标时(每几百毫秒)触发。

dragover 事件在可拖动的元素或者被选择的文本被拖进一个有效的放置目标时(每几百毫秒)触发。

该事件在放置目标上触发。

语法

在 EventTarget.addEventListener 等方法中使用事件名称,或者设置事件处理器属性。

addEventListener("dragover", (event) => {});

ondragover = (event) => {};

事件类型

一个 DragEvent。继承自 Event。

DragEvent

事件属性

除了以下的属性,来自父接口 Event 的属性也是可用的。

  • DragEvent.dataTransfer
    • : 在拖放交互期间转移的数据。

示例

一个小巧的拖放示例

在该示例中,我们在容器中有一个可拖动的元素。尝试抓住元素,拖动它进入另一个容器,然后释放它。

在这里,我们有三个事件处理程序:

  • 在 dragstart 事件处理程序中,我们得到了用户拖动元素的引用。
  • 在目标容器的 dragover 事件处理程序中,我们调用 event.preventDefault(),这使它能够接收 drop 事件。
  • 在放置区域的 drop 事件处理程序中,我们将可拖动的元素从原始区域移动到可放置区域。

关于更完整的拖放示例,请参见 drag 事件。

HTML

<div class="dropzone">
  <div id="draggable" draggable="true">This div is draggable</div>
</div>
<div class="dropzone" id="droptarget"></div>

CSS

body {
  /* Prevent the user selecting text in the example */
  user-select: none;
}

#draggable {
  text-align: center;
  background: white;
}

.dropzone {
  width: 200px;
  height: 20px;
  background: blueviolet;
  margin: 10px;
  padding: 10px;
}

JavaScript

let dragged = null;

const source = document.getElementById("draggable");
source.addEventListener("dragstart", (event) => {
  // store a ref. on the dragged elem
  dragged = event.target;
});

const target = document.getElementById("droptarget");
target.addEventListener("dragover", (event) => {
  // prevent default to allow drop
  event.preventDefault();
});

target.addEventListener("drop", (event) => {
  // prevent default action (open as link for some elements)
  event.preventDefault();
  // move dragged element to the selected drop target
  if (event.target.className === "dropzone") {
    dragged.parentNode.removeChild(dragged);
    event.target.appendChild(dragged);
  }
});

结果

一个小巧的拖放示例

规范

浏览器兼容性

参见

  • 其他拖放事件:

    • HTMLElement/drag_event
    • HTMLElement/dragstart_event
    • HTMLElement/dragend_event
    • HTMLElement/dragenter_event
    • HTMLElement/dragleave_event
    • HTMLElement/drop_event
  • 其他目标中的该事件:

    • Window:Window/dragover_event 事件
    • Document:Document/dragover_event 事件
    • SVGElement:SVGElement/dragover_event 事件

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

资料来源与适用范围

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

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

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