CKTIS / HTML
ondragend — tratar o fim de um arrastamento
O atributo ondragend executa JavaScript quando uma operação de arrastamento termina, incluindo quando é cancelada ou a tentativa de largar não tem êxito. É útil para limpar o estado do elemento de origem, não para confirmar que um destino aceitou os dados.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
ondragend="JavaScript statements"ondragend é um atributo de conteúdo de controlador de eventos para dragend, permitido em todos os elementos HTML. O seu valor é código JavaScript, não um valor booleano. No código do atributo, o parâmetro event fornece o objeto do evento. O atributo não ativa, por si só, o arrastamento; o exemplo usa draggable="true" para esse efeito.
O evento dragend é enviado à origem quando a operação de arrastamento termina, incluindo em caso de cancelamento ou de tentativa de largar rejeitada. Ao contrário de drop, não é o evento que indica a aceitação dos dados pelo destino. É útil para remover os indicadores visuais de arrastamento. Consulta event.dataTransfer.dropEffect para verificar o resultado da operação; none significa que não foi realizada nenhuma operação.
Em JavaScript, também podes atribuir uma função à propriedade element.ondragend ou registar um listener com element.addEventListener('dragend', handler). O nome do evento é dragend, sem o prefixo on. A política Content Security Policy pode bloquear código escrito diretamente num atributo; nesse ambiente, usa um script permitido com addEventListener.
O exemplo define o texto do estado como Drag ended, quer a tentativa de largar tenha êxito ou não. Não implementa um destino para largar nem a transferência de dados.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
ondragend="document.getElementById('status').textContent = 'Drag ended'">
Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>Resultado
Drag ended
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.