Evento ondragenter
Definição e uso
O evento ondragenter ocorre quando o elemento arrastável ou a seleção de texto entra no destino de arrasto válido.
os eventos ondragenter e ondragleave ajudam os usuários a entenderem quando um elemento arrastável está prestes a entrar ou sair do destino de arrasto. Por exemplo, pode-se definir uma cor de fundo quando o elemento entra no destino e remove-la quando o elemento sai do destino.
Arrasto e soltura é uma funcionalidade muito comum no HTML5. É quando você "puxa" um objeto e o arrasta para diferentes posições. Para saber mais, leia nossos artigos 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.
Durante diferentes estágios da operação de arrasto e soltura, muitos eventos são usados e podem ocorrer:
Eventos acionados no 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 o arrasto do elemento
Eventos acionados no destino de arrasto:
- ondragenter - Ocorre quando o elemento arrastável entra no destino de arrasto
- ondragover - Ocorre quando o elemento arrastável está no destino de arrasto
- ondragleave - Ocorre quando o elemento arrastável sai do destino de arrasto
- ondrop - Ocorre quando o elemento arrastável é colocado no destino de arrasto
Exemplo
Execute JavaScript quando o elemento arrastável entrar no destino de arrasto:
<div ondragenter="myFunction(event)"></div>
Mais exemplos TIY na parte inferior da página.
Sintaxe
No HTML:
<element ondragenter="myScript">
No JavaScript:
object.ondragenter = function(){myScript};
No JavaScript, use o método addEventListener():
object.addEventListener("dragenter", 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 |
|---|---|---|---|---|---|
| ondragenter | 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 ou elementos em outros elementos. Para permitir a soltura, devemos impedir 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 - Prevenir 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")
Adicionar 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>
