DragEvent:dataTransfer 屬性

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

DragEvent.dataTransfer 唯讀屬性用來保存拖曳操作的資料(以 DataTransfer 物件表示)。

一個 DataTransfer 物件,其中包含拖曳事件的資料

當事件是透過建構子建立時,此屬性可能為 null。但當事件由瀏覽器派發時,該屬性永遠不會為 null

範例

以下範例展示了如何在 dragend 事件處理器中存取拖曳與放置的資料。

js
function processData(d) {
  // 處理資料 …
}

dragTarget.addEventListener(
  "dragend",
  (ev) => {
    // 呼叫拖曳與放置資料處理器
    if (ev.dataTransfer !== null) processData(ev.dataTransfer);
  },
  false,
);

規範

Specification
HTML
# dom-dragevent-datatransfer-dev

瀏覽器相容性