Evento ondragover
Definição e uso
Ocorre o evento ondragover quando o elemento arrastável ou a seleção de texto é arrastado para o destino de colocação válido.
Por padrão, não é possível excluir dados/elementos em outros elementos. Para permitir a colocação, devemos bloquear o tratamento padrão do elemento. Isso é feito chamando o método event.preventDefault() do evento ondragover.
O arrasto e soltura é uma funcionalidade 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 no 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.
Em diferentes estágios da operação de arrastar e soltar, muitos eventos são usados e podem ocorrer:
Eventos acionados no elemento alvo (elemento de origem) que pode ser arrastado:
- ondragstart - Quando o usuário começar a arrastar o elemento ocorre
- ondrag - Quando o elemento for arrastado ocorre
- ondragend - Quando o usuário completar o arrasto do elemento ocorre
Eventos acionados no destino de colocação:
- ondragenter - Quando o elemento arrastado entrar no destino de colocação ocorre
- ondragover - Quando o elemento arrastado estiver no destino de colocação ocorre
- ondragleave - Quando o elemento arrastado sair do destino de colocação ocorre
- ondrop - Quando o elemento arrastado for colocado no destino de colocação ocorre
Notas:Quando o elemento for arrastado, o evento ondragover é acionado a cada 350 milissegundos.
Exemplo
Execute JavaScript quando o elemento for arrastado para o destino de colocação:
<div ondragover="myFunction(event)"></div>
Mais exemplos TIY no rodapé da página.
Sintaxe
No HTML:
<element ondragover="myScript">
No JavaScript:
object.ondragover = function(){myScript};
No JavaScript, use o método addEventListener():
object.addEventListener("dragover", 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 |
|---|---|---|---|---|---|
| ondragover | 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 depósito ----------------- */
// 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 depositar dados / elementos em outros elementos. Para permitir o depósito, 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 arrastar para soltar, abre 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>
