ondragover 事件

实例

当元素被拖放到放置目标上时执行 JavaScript：

<div ondragover="myFunction(event)"></div>

亲自试一试

页面下方有更多 TIY 实例。

定义和用法

当可拖动元素或文本选择被拖动到有效放置目标上时，会发生 ondragover 事件。

默认情况下，不能在其他元素中删除数据/元素。为了允许放置，我们必须阻止元素的默认处理。这是通过调用 ondragover 事件的 event.preventDefault() 方法来实现的。

拖放是 HTML5 中非常常见的功能。就是当您“抓取”一个对象并将其拖动到不同位置时。如需学习更多知识，请阅读我们关于 HTML5 拖放的 HTML 教程。

注释：如需使元素可拖动，请使用全局 HTML5 draggable 属性。

提示：默认情况下，链接和图像是可拖动的，不需要 draggable 属性。

在拖放操作的不同阶段，有许多事件被使用，并且可能发生：

在可拖动目标（源元素）上触发的事件：

• ondragstart - 当用户开始拖动元素时发生
• ondrag - 当元素被拖动时发生
• ondragend - 当用户完成拖动元素时发生

在放置目标上触发的事件：

• ondragenter - 当被拖动的元素进入放置目标时发生
• ondragover - 当被拖动的元素在放置目标上时发生
• ondragleave - 当被拖动的元素离开放置目标时发生
• ondrop - 当被拖动的元素被放在放置目标上时发生

注释：拖动元素时，ondragover 事件每 350 毫秒触发一次。

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

语法

在 HTML 中：

<element ondragover="myScript">

亲自试一试

在 JavaScript 中：

object.ondragover = function(){myScript};

亲自试一试

在 JavaScript 中，使用 addEventListener() 方法：

object.addEventListener("dragover", myScript);

亲自试一试

注释：Internet Explorer 8 或更早的版本不支持 addEventListener() 方法。

技术细节

更多实例

对所有可能的拖放事件的演示：

<p draggable="true" id="dragtarget">Drag me!</p>

<div class="droptarget">Drop here!</div>

<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */

document.addEventListener("dragstart", function(event) {
  // dataTransfer.setData()方法设置被拖拽数据的数据类型和值
  event.dataTransfer.setData("Text", event.target.id);

  // 开始拖动 p 元素时输出一些文本
  document.getElementById("demo").innerHTML = "Started to drag the p element.";

  // 更改可拖动元素的不透明度
  event.target.style.opacity = "0.4";
});

// 拖动 p 元素时，更改输出文本的颜色
document.addEventListener("drag", function(event) {
  document.getElementById("demo").style.color = "red";
});

// 完成拖动 p 元素后输出一些文本并重置不透明度
document.addEventListener("dragend", function(event) {
  document.getElementById("demo").innerHTML = "Finished dragging the p element.";
  event.target.style.opacity = "1";
});


/* ----------------- 在放置目标上触发的事件 ----------------- */

// 当可拖动的 p 元素进入 droptarget 时，改变 DIV 的边框样式
document.addEventListener("dragenter", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});

// 默认情况下，不能在其他元素中放置数据/元素。为了允许放置，我们必须阻止元素的默认处理
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});

// 当可拖动的 p 元素离开 droptarget 时，重置 DIV 的边框样式
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});

/* On drop - 防止浏览器对数据的默认处理（默认放置时以链接打开）
重置输出文本的颜色和 DIV 的边框颜色
使用 dataTransfer.getData() 方法获取拖动的数据
被拖拽的数据是被拖拽元素的 id ("drag1")
将被拖动的元素附加到放置元素中
*/
document.addEventListener("drop", function(event) {
  event.preventDefault();
  if ( event.target.className == "droptarget" ) {
    document.getElementById("demo").style.color = "";
    event.target.style.border = "";
    var data = event.dataTransfer.getData("Text");
    event.target.appendChild(document.getElementById(data));
  }
});
</script>

亲自试一试

相关页面

HTML 教程：HTML5 拖放

HTML 参考手册：HTML draggable 属性