HTMLElement：drop 事件

当元素或文本选择被放置到有效的放置目标上时，将触发drop 事件。为了确保 drop 事件始终按预期触发，您应该始终在处理 dragover 事件的代码部分中包含 preventDefault() 调用。

此事件是可取消的，并且可能会冒泡到 Document 和 Window 对象。

语法

在诸如 addEventListener() 的方法中使用事件名称，或设置事件处理程序属性。

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

ondrop = (event) => {};

事件类型

一个 DragEvent。继承自 Event。

事件属性

除了下面列出的属性外，父接口 Event 的属性也可用。

DragEvent.dataTransfer 只读: 在拖放交互期间传输的数据。

示例

一个最小的拖放示例

在此示例中，我们在容器内有一个可拖动的元素。尝试抓住该元素，将其拖到另一个容器上，然后释放它。

我们在这里使用了三个事件处理程序

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

有关拖放的更完整示例，请参阅 drag 事件的页面。

HTML

html

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

CSS

css

body {
  /* Prevent the user from 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 a 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);
  }
});

结果

规范

规范
HTML 标准 # ix-handler-ondrop
HTML 标准 # event-dnd-drop

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅

其他拖放事件