CKTIS / HTML
ondrop — processar dados largados
O atributo ondrop define código JavaScript que processa o evento drop durante o arrastamento e largada. Por si só, não cria um destino para largar: normalmente também é necessário cancelar o comportamento predefinido de dragover.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop é um atributo global de tratamento de eventos HTML: pode aparecer em qualquer elemento HTML. O seu valor é código JavaScript executado quando é recebido um evento drop, ou seja, quando os dados são largados num destino aceite. O objeto event expõe o evento e event.dataTransfer expõe os dados transferidos.
Um handler ondrop, por si só, não estabelece um destino de largada típico. Chama event.preventDefault() no handler dragover para permitir a largada. O exemplo também cancela dragenter. No handler drop, usa novamente event.preventDefault() para assumir a ação predefinida e lê o texto com event.dataTransfer.getData('text/plain').
Distingue o atributo HTML ondrop, cujo valor é texto de código-fonte, da propriedade DOM element.ondrop, à qual se atribui uma função ou null. O nome do evento é drop, não ondrop; com addEventListener, usa-se drop. Atribuir novamente a element.ondrop substitui a função anterior registada através desse mecanismo.
O exemplo transfere o texto fixo Hello e apresenta-o através de textContent, sem interpretar os dados como HTML. Requer um ambiente que permita scripts e handlers de eventos inline; as restrições de segurança do documento podem bloqueá-los.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>Resultado
Hello
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.