Evento ondragleave
Definição e uso
Ocorre o evento ondragleave quando o elemento arrastável ou a seleção de texto sai do destino de largada válido.
Os eventos ondragenter e ondragleave ajudam o usuário a entender que um elemento arrastável está prestes a entrar ou sair do destino de largada. Por exemplo, pode-se definir a cor de fundo ao entrar no destino de largada e removê-la quando o elemento sair do destino.
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 nossa seção sobre Arrastar e soltar HTML5do HTML.
Notas:Para tornar o 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.
Existem muitos eventos 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 finaliza o arrasto do elemento
Eventos acionados no destino de largada:
- ondragenter - Ocorre quando o elemento arrastável entra no destino de largada
- ondragover - Ocorre quando o elemento arrastável está no destino de largada
- ondragleave - Ocorre quando o elemento arrastável sai do destino de largada
- ondrop - Ocorre quando o elemento arrastável é colocado no destino de largada
实例
Executa JavaScript quando o elemento arrastável sai do destino de largada:
<div ondragleave="myFunction(event)"></div>
Abaixo há mais exemplos TIY.
Sintaxe
No HTML:
<elemento ondragleave="myScript">
No JavaScript:
objeto.ondragleave = function(){myScript};
No JavaScript, use o método addEventListener():
objeto.addEventListener("dragleave", myScript);
Notas: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 |
|---|---|---|---|---|---|
| ondragleave | 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 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 por 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>
