1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
|
---
title: DragEvent
slug: Web/API/DragEvent
tags:
- API
- DragEvent
- Reference
- drag and drop
translation_of: Web/API/DragEvent
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>
<p>The <strong><code>DragEvent</code></strong> interface is a {{domxref("Event","DOM event")}} that represents a drag and drop interaction. 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.</p>
<p class="note">This interface inherits properties from {{domxref("MouseEvent")}} and {{domxref("Event")}}.</p>
<h2 id="Properties">Properties</h2>
<dl>
<dt>{{domxref('DragEvent.dataTransfer')}} {{readonlyInline}}</dt>
<dd>The data that is transferred during a drag and drop interaction.</dd>
</dl>
<h2 id="Constructors">Constructors</h2>
<p class="note">Although this interface has a constructor, it is not possible to create a useful DataTransfer object from script, since {{domxref("DataTransfer")}} objects have a processing and security model that is coordinated by the browser during drag-and-drops.</p>
<dl>
<dt>{{domxref("DragEvent.DragEvent", "DragEvent()")}}</dt>
<dd>Creates a synthetic and untrusted DragEvent.</dd>
</dl>
<h2 id="Event_types">Event types</h2>
<dl>
<dt>{{event('drag')}}</dt>
<dd>This event is fired when an element or text selection is being dragged.</dd>
<dt>{{event('dragend')}}</dt>
<dd>This event is fired when a drag operation is being ended (by releasing a mouse button or hitting the escape key).</dd>
<dt>{{event('dragenter')}}</dt>
<dd>This event is fired when a dragged element or text selection enters a valid drop target.</dd>
<dt>{{event('dragexit')}}</dt>
<dd>This event is fired when an element is no longer the drag operation's immediate selection target.</dd>
<dt>{{event('dragleave')}}</dt>
<dd>This event is fired when a dragged element or text selection leaves a valid drop target.</dd>
<dt>{{event('dragover')}}</dt>
<dd>This event is fired continuously when an element or text selection is being dragged and the mouse pointer is over a valid drop target (every 50 ms WHEN mouse is not moving ELSE much faster between 5 ms (slow movement) and 1ms (fast movement) approximately. This firing pattern is different than {{Event("mouseover")}} ).</dd>
<dt>{{event('dragstart')}}</dt>
<dd>This event is fired when the user starts dragging an element or text selection.</dd>
<dt>{{event('drop')}}</dt>
<dd>This event is fired when an element or text selection is dropped on a valid drop target.</dd>
</dl>
<h2 id="GlobalEventHandlers">GlobalEventHandlers</h2>
<dl>
<dt>{{domxref('GlobalEventHandlers.ondrag')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('drag')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragend')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragend')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragenter')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragenter')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragexit')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragexit')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragleave')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragleave')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragover')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragover')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondragstart')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('dragstart')}} event.</dd>
<dt>{{domxref('GlobalEventHandlers.ondrop')}}</dt>
<dd>A {{domxref('GlobalEventHandlers','global event handler')}} for the {{event('drop')}} event.</dd>
</dl>
<h2 id="Example">Example</h2>
<p>An Example of each property, constructor, event type and global event handlers is included in their respective reference page.</p>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Specification</th>
<th scope="col">Status</th>
<th scope="col">Comment</th>
</tr>
<tr>
<td>{{SpecName("HTML WHATWG", "#dragevent", "DragEvent")}}</td>
<td>{{Spec2("HTML WHATWG")}}</td>
<td> </td>
</tr>
<tr>
<td>{{SpecName("HTML5.1", "editing.html#the-dragevent-interface", "DragEvent")}}</td>
<td>{{Spec2("HTML5.1")}}</td>
<td>Initial definition</td>
</tr>
</tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>{{Compat("api.DragEvent")}}</p>
<h2 id="See_also">See also</h2>
<p>{{page("/en-US/docs/Web/API/DataTransfer", "See also")}}</p>
|
