---
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>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>4</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>10</td>
   <td>12</td>
   <td>3.1</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Android Webview</th>
   <th>Chrome for Android</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatIE("10")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
  </tr>
 </tbody>
</table>
</div>

<p>&lt;embed height="0" id="xunlei_com_thunder_helper_plugin_d462f475-c18e-46be-bd10-327458d045bd" type="application/thunder_download_plugin" width="0"&gt;</p>