Evento ondrag

Eventos DOM DragEvent

Definição e uso

O evento ondrag ocorre quando o elemento ou a seleção de texto é arrastado.

Arraste e solte é uma função 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 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 arraste 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 arraste 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

Notas:Ao arrastar o elemento, o evento ondrag é acionado a cada 350 milissegundos.

Exemplo

Ao arrastar o elemento <p>, execute JavaScript:

<p draggable="true" ondrag="myFunction(event)">Arraste-me!</p>

Experimente você mesmo

Mais exemplos TIY na parte inferior da página.

Sintaxe

No HTML:

<element ondrag="myScript">

Experimente você mesmo

No JavaScript:

object.ondrag = function(){myScript};

Experimente você mesmo

No JavaScript, use o método addEventListener():

object.addEventListener("drag", myScript);

Experimente você mesmo

Notas:Internet Explorer 8 ou versões anteriores não suportam addEventListener() 方法。

技术细节

冒泡： 支持
可取消： 支持
事件类型： DragEvent
支持的 HTML 标签： 所有 HTML 元素
DOM 版本： Level 3 Events

浏览器支持

表中的数字注明了完全支持该事件的首个浏览器版本。

事件 Chrome IE Firefox Safari Opera
ondrag 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 colocação ----------------- */
// Quando o elemento arrastável p 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";
  }
});
// Padrãomente, não é possível colar dados/em elementos em outros elementos. Para permitir que a colagem seja permitida, devemos impedir o tratamento padrão do elemento
document.addEventListener("dragover", function(event) {
  event.preventDefault();
});
// Quando o elemento arrastável p 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) */
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>

Experimente você mesmo

Páginas relacionadas

Tutoriais HTML:Arrastar e soltar HTML5

Manual de referência HTML:Propriedade draggable do HTML

Eventos DOM DragEvent