ondragend-händelse

DOM-händelser DragEvent

Definition och användning

En ondragend-händelse inträffar när användaren slutför att dra ett element eller en textmarkering.

Drag-och-släpp är en mycket vanlig funktion i HTML5. Det är när du "tar tag på" ett objekt och drar det till olika platser. För att lära dig mer, läs vår HTML5-drag och släppHTML-guide.

Kommentar:För att göra ett element dragbart, använd global HTML5 draggable-attribut。

Tips:Som standard är länkar och bilder dragbara utan att behöva draggable-attribut.

Under olika faser av drag-och-släpp-operationen används många händelser och kan inträffa:

Uppkommande händelser på källor (käll element):

  • ondragstart - Inträffar när användaren börjar dra elementet
  • ondrag - Inträffar när elementet dras
  • ondragend - Inträffar när användaren slutför att dra elementet

Uppkommande händelser på måltillfället:

  • ondragenter - Inträffar när den dragbara elementen kommer in på måltillfället
  • ondragover - Inträffar när den dragbara elementen finns på måltillfället
  • ondragleave - Inträffar när den dragbara elementen lämnar måltillfället
  • ondrop - Inträffar när den dragbara elementen placeras på måltillfället

Exempel

När användaren slutför att dra <p>-elementet, körs JavaScript:

<p draggable="true" ondragend="myFunction(event)">Drag mig!</p>

亲自试一试

På sidans nederdel finns fler TIY-exempel.

Syntaks

I HTML:

<element ondragend="myScript">

亲自试一试

I JavaScript:

object.ondragend = function(){myScript};

亲自试一试

I JavaScript, använda addEventListener() metoden:

object.addEventListener("dragend", myScript);

亲自试一试

Kommentar:Internet Explorer 8 eller tidigare versioner stöder inte addEventListener() metoden。

技术细节

冒泡： 支持
可取消： 不支持
事件类型： DragEvent
支持的 HTML 标签： 所有 HTML 元素
DOM 版本： Level 3 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
ondragend 4.0 9.0 3.5 6.0 12.0

更多实例

对所有可能的拖放事件的演示：

<p draggable="true" id="dragtarget">Drag me!</p>
<div class="droptarget">Drop here!</div>
<script>
/* ----------------- 在拖动目标上触发的事件 ----------------- */
document.addEventListener("dragstart", function(event) {
  // dataTransfer.setData()方法设置被拖拽数据的数据类型和值
  event.dataTransfer.setData("Text", event.target.id);
  // 开始拖动 p 元素时输出一些文本
  document.getElementById("demo").innerHTML = "Started to drag the p element.";
  // 更改可拖动元素的不透明度
  event.target.style.opacity = "0.4";
});
// 拖动 p 元素时，更改输出文本的颜色
document.addEventListener("drag", function(event) {
  document.getElementById("demo").style.color = "red";
});
// 完成拖动 p 元素后输出一些文本并重置不透明度
document.addEventListener("dragend", function(event) {
  document.getElementById("demo").innerHTML = "Finished dragging the p element.";
  event.target.style.opacity = "1";
});
/* ----------------- 在放置目标上触发的事件 ----------------- */
// 当可拖动的 p 元素进入 droptarget 时，改变 DIV 的边框样式
document.addEventListener("dragenter", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "3px dotted red";
  }
});
// 默认情况下，不能在其他元素中放置数据/元素。为了允许放置，我们必须阻止元素的默认处理
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});
// 当可拖动的 p 元素离开 droptarget 时，重置 DIV 的边框样式
document.addEventListener("dragleave", function(event) {
  if ( event.target.className == "droptarget" ) {
    event.target.style.border = "";
  }
});
/* 防止浏览器对数据的默认处理（默认放置时以链接打开）
重置输出文本的颜色和 DIV 的边框颜色
使用 dataTransfer.getData() 方法获取拖动的数据
被拖拽的数据是被拖拽元素的 id ("drag1")
将被拖动的元素附加到放置元素中
*/
document.addEventListener("drop", function(event) {
  event.preventDefault();
  if ( event.target.className == "droptarget" ) {
    document.getElementById("demo").style.color = "";
    event.target.style.border = "";
    var data = event.dataTransfer.getData("Text");
    event.target.appendChild(document.getElementById(data));
  }
});
</script>

亲自试一试

相关页面

HTML 教程：HTML5 拖放

HTML 参考手册：HTML draggable 属性

DOM-händelser DragEvent