aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/dragevent/index.html
blob: 73dcd7838cc0cd73178c52288c514584deef46b0 (plain)
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
---
title: DragEvent
slug: Web/API/DragEvent
translation_of: Web/API/DragEvent
---
<div>{{APIRef("HTML Drag and Drop API")}}</div>

<p><strong><code>DragEvent</code></strong> 是一个表示拖、放交互的一个{{domxref("Event","DOM event")}} 接口。用户通过将指针设备(例如鼠标)放置在触摸表面上并且然后将指针拖动到新位置(诸如另一个DOM元素)来发起拖动。 应用程序可以按应用程序特定的方式自由解释拖放交互。</p>

<p class="note">这个接口继承 {{domxref("MouseEvent")}}{{domxref("Event")}}属性</p>

<h2 id="属性">属性</h2>

<dl>
 <dt>{{domxref('DragEvent.dataTransfer')}} {{readonlyInline}}</dt>
 <dd>在拖放交互期间传输的数据。</dd>
</dl>

<h2 id="构造函数">构造函数</h2>

<p class="note">虽然这个接口有一个构造函数,但不可能从脚本创建一个有用的 DataTransfer 对象,因为在拖放期间,有一个由浏览器分配的一个处理中和安全模式的{{domxref("DataTransfer")}}对象。</p>

<dl>
 <dt>{{domxref("DragEvent.DragEvent", "DragEvent()")}}</dt>
 <dd>创建合成和不可信的 DragEvent.</dd>
</dl>

<h2 id="事件类型">事件类型</h2>

<dl>
 <dt>{{event('drag')}}</dt>
 <dd>拖动元素或选择文本时触发此事件。</dd>
 <dt>{{event('dragend')}}</dt>
 <dd>当拖动操作结束时(释放鼠标按钮或按下退出键),会触发此事件。</dd>
 <dt>{{event('dragenter')}}</dt>
 <dd>当拖动的元素或选择文本输入有效的放置目标时,会触发此事件。</dd>
 <dt>{{event('dragexit')}}</dt>
 <dd>当元素不再是拖动操作的选择目标时触发此事件。</dd>
 <dt>{{event('dragleave')}}</dt>
 <dd>当拖动的元素或文本选择离开有效的放置目标时,会触发此事件。</dd>
 <dt>{{event('dragover')}}</dt>
 <dd>当将元素或文本选择拖动到有效放置目标(每几百毫秒)上时,会触发此事件。</dd>
 <dt>{{event('dragstart')}}</dt>
 <dd>当用户开始拖动元素或选择文本时触发此事件。</dd>
 <dt>{{event('drop')}}</dt>
 <dd>当在有效放置目标上放置元素或选择文本时触发此事件。</dd>
</dl>

<h2 id="全局事件处理">全局事件处理</h2>

<dl>
 <dt>{{domxref('GlobalEventHandlers.ondrag')}}</dt>
 <dd>{{event('drag')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragend')}}</dt>
 <dd>{{event('dragend')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragenter')}}</dt>
 <dd>{{event('dragenter')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragexit')}}</dt>
 <dd>{{event('dragexit')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragleave')}}</dt>
 <dd>{{event('dragleave')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragover')}}</dt>
 <dd>{{event('dragover')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondragstart')}}</dt>
 <dd>{{event('dragstart')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
 <dt>{{domxref('GlobalEventHandlers.ondrop')}}</dt>
 <dd>{{event('drop')}} 事件的{{domxref('GlobalEventHandlers','全局事件处理')}}</dd>
</dl>

<h2 id="示例">示例</h2>

<p>每个属性,构造函数,事件类型和全局事件处理程序的示例都包含在它们各自的参考页中。</p>

<h2 id="规范">规范</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", "interaction.html#the-dragevent-interface", "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="浏览器兼容性">浏览器兼容性</h2>

{{Compat("api.DragEvent")}}