DragEvent

DragEvent 介面是一種 DOM event，定義了拖放操作時產生的事件物件。The user initiates a drag by placing a pointer device (such as a mouse) on the touch surface and then dragging the pointer to a new location (such as another DOM element). Applications are free to interpret a drag and drop interaction in an application-specific way.

This interface inherits properties from MouseEvent and Event.

屬性

DragEvent.dataTransfer Read only

The data that is transferred during a drag and drop interaction.

建構式

Although this interface has a constructor, it is not possible to create a useful DataTransfer object from script, since DataTransfer objects have a processing and security model that is coordinated by the browser during drag-and-drops.

DragEvent()

Creates a synthetic and untrusted DragEvent.

事件類型

drag

在『被選擇的物件』被拖曳時觸發。

dragend

在『被選擇的物件』結束拖曳時觸發 (就是放開滑鼠鍵、或按下 Esc 鍵時)。

dragenter

當『被選擇的物件』被拖曳到『可以當目標的物件』時, 在『進入』該目標物件上方的瞬間觸發。注意, 不是『被選擇的物件』觸發此事件, 而是『可以當目標的物件』。

dragexit

This event is fired when an element is no longer the drag operation's immediate selection target.

dragleave

當『被選擇的物件』被拖曳到『可以當目標的物件』時, 在『離開』該目標物件上方的瞬間觸發。注意, 不是『被選擇的物件』觸發此事件, 而是『可以當目標的物件』。

dragover

當『被選擇的物件』被拖曳到『可以當目標的物件』的上方時觸發 (頻率大約每秒數次)。注意, 不是『被選擇的物件』觸發此事件, 而是『可以當目標的物件』 。

dragstart

在『被選擇的物件』開始拖曳時觸發。

drop

當『被選擇的物件』被拖曳、放到『目標物件』時觸發。注意, 不是『被選擇的物件』觸發此事件, 而是『目標物件』。

通用事件處理器

GlobalEventHandlers.ondrag

A global event handler for the drag event.

GlobalEventHandlers.ondragend

A global event handler for the dragend event.

GlobalEventHandlers.ondragenter

A global event handler for the dragenter event.

GlobalEventHandlers.ondragexit

A global event handler for the dragexit event.

GlobalEventHandlers.ondragleave

A global event handler for the dragleave event.

GlobalEventHandlers.ondragover

A global event handler for the dragover event.

GlobalEventHandlers.ondragstart

A global event handler for the dragstart event.

GlobalEventHandlers.ondrop

A global event handler for the drop event.

範例

An Example of each property, constructor, event type and global event handlers is included in their respective reference page.

規範

瀏覽器相容性

參見

• Drag and drop
• Drag Operations
• Recommended Drag Types
• Dragging and Dropping Multiple Items