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

This event is fired when an element or text selection is being dragged.

dragend

This event is fired when a drag operation is being ended (by releasing a mouse button or hitting the escape key).

dragenter

This event is fired when a dragged element or text selection enters a valid drop target.

dragexit

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

dragleave

This event is fired when a dragged element or text selection leaves a valid drop target.

dragover

This event is fired when an element or text selection is being dragged over a valid drop target (every few hundred milliseconds).

dragstart

This event is fired when the user starts dragging an element or text selection.

drop

This event is fired when an element or text selection is dropped on a valid drop target.

通用事件處理器

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