HTMLElement: drop 事件

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

當一個元素或文字選擇被拖放到一個有效的拖放目標上時,會觸發 drop 事件。為了確保 drop 事件始終按預期觸發,您應該在處理 dragover 事件的程式碼部分始終包含一個 preventDefault() 呼叫。

此事件是可取消的,並且可能會冒泡到 DocumentWindow 物件。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

ondrop = (event) => { }

事件型別

一個 DragEvent。繼承自 Event

Event UIEvent MouseEvent DragEvent

事件屬性

除了下面列出的屬性之外,父介面 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="drop-target"></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

js
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("drop-target");
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
# handler-ondrop
HTML
# event-dnd-drop

瀏覽器相容性

另見