Evento ondrop
Definição e uso
O evento ondrop ocorre quando um elemento arrastável ou seleção de texto é colocado em um destino de colocação válido.
Arrastar e soltar é uma funcionalidade muito comum no HTML5. É quando você 'puxa' um objeto e o arrasta para diferentes posições. Para saber mais, leia nossa seção sobre Arrastar e soltar HTML5do HTML.
Notas:Para tornar um elemento arrastável, use o tutorial global Propriedade draggable do HTML5。
Dica:Por padrão, links e imagens são arrastáveis, não é necessário a propriedade draggable.
Muitos eventos são usados em diferentes estágios da operação de arrastar e soltar, e podem ocorrer:
Eventos acionados no elemento 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 o arrasto do elemento
Eventos acionados no destino de colocação:
- ondragenter - Ocorre quando o elemento arrastado entra no destino de colocação
- ondragover - Ocorre quando o elemento arrastado está no destino de colocação
- ondragleave - Ocorre quando o elemento arrastado sai do destino de colocação
- ondrop - Ocorre quando o elemento arrastado é colocado no destino de colocação
Exemplo
Executar JavaScript no elemento <div> ao arrastar elementos dentro dele:
<div ondrop="myFunction(event)"></div>
Mais exemplos TIY na parte inferior da página.
Sintaxe
No HTML:
<elemento ondrop="myScript">
No JavaScript:
objeto.ondrop = function(){myScript};
No JavaScript, use o método addEventListener():
objeto.addEventListener("drop", myScript);
Notas:Internet Explorer 8 ou versões anteriores não suportam addEventListener() 方法。
技术细节
| 冒泡： | 支持 |
|---|---|
| 可取消： | 支持 |
| 事件类型： | DragEvent |
| 支持的 HTML 标签： | 所有 HTML 元素 |
| DOM 版本： | Level 3 Events |
浏览器支持
表中的数字注明了完全支持该事件的首个浏览器版本。
| 事件 | Chrome | IE | Firefox | Safari | Opera |
|---|---|---|---|---|---|
| ondrop | 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 impedir o tratamento 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 - Prevenir o tratamento 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>
