Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes