Evento ondragend
Definição e uso
O evento ondragend ocorre quando o usuário completa a arrastar o elemento ou a seleção de texto.
Arrastar e soltar é uma função muito comum no HTML5. É quando você "puxa" um objeto e o arrasta para diferentes posições. Para aprender mais, leia nosso sobre Arrastar e soltar no HTML5do HTML.
Observação：Para tornar o elemento arrastável, use o tutorial global Propriedade draggable do HTML5。
Dica：Por padrão, os links e as imagens são arrastáveis, não é necessário a propriedade draggable.
Em diferentes estágios da operação de arrastar e soltar, muitos eventos são usados e podem ocorrer：
Eventos acionados no elemento de destino arrastável (elemento de origem)：
- ondragstart - Ocorre quando o usuário começa a arrastar o elemento
- ondrag - Ocorre quando o elemento é arrastado
- ondragend - Ocorre quando o usuário completa a arrastar o elemento
Eventos acionados no destino de arrasto：
- ondragenter - Ocorre quando o elemento arrastado entra no destino de arrasto
- ondragover - Ocorre quando o elemento arrastado está no destino de arrasto
- ondragleave - Ocorre quando o elemento arrastado sai do destino de arrasto
- ondrop - Ocorre quando o elemento arrastado é colocado no destino de arrasto
Exemplo
Quando o usuário completar a arrastar o elemento <p> execute JavaScript：
<p draggable="true" ondragend="myFunction(event)">Arraste-me!</p>
Mais exemplos TIY na parte inferior da página.
Sintaxe
No HTML：
<elemento ondragend="myScript">
No JavaScript：
objeto.ondragend = function(){myScript};
No JavaScript, use o método addEventListener()：
objeto.addEventListener("dragend", myScript);
Observação：O Internet Explorer 8 ou versões anteriores não suportam Método addEventListener()。
技术细节
| 冒泡： | 支持 |
|---|---|
| 可取消： | 不支持 |
| 事件类型： | 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";
});
/* ----------------- Eventos acionados no ponto de destino de soltura ----------------- */
// Quando o elemento p arrastável entra no droptarget, alterar o estilo da borda do DIV
document.addEventListener("dragenter", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "3px dotted red";
}
});
// Por padrão, não é possível soltar dados/elementos em outros elementos. Para permitir a soltura, devemos bloquear o processamento padrão do elemento
document.addEventListener("dragover", function(event) {
event.preventDefault();
});
// Quando o elemento p arrastável sai do droptarget, redefinir o estilo da borda do DIV
document.addEventListener("dragleave", function(event) {
if ( event.target.className == "droptarget" ) {
event.target.style.border = "";
}
});
/* No drop - evitar o processamento padrão do navegador dos dados (ao soltar como link padrão)
Redefinir a cor do texto de saída e a cor da borda do DIV
Obter os dados arrastados usando o método dataTransfer.getData()
Os dados arrastados são o id do elemento arrastado ("drag1")
Anexar o elemento arrastado ao elemento de destino
*/
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>
