CKTIS / HTML
ondragleave — gerir a saída de um destino de arrastamento
O atributo ondragleave contém JavaScript que gere o evento dragleave. Pode, por exemplo, remover o destaque do destino anterior durante um arrastamento; não significa que toda a operação de arrastamento tenha terminado.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
ondragleave="JavaScript statements"ondragleave é um atributo de tratamento de eventos disponível nos elementos HTML. O seu valor é o corpo de uma função JavaScript, não o nome de um evento nem um valor booleano. Corresponde ao evento dragleave; no código do atributo, event representa o evento e this refere-se ao elemento que o trata.
O navegador envia dragleave ao elemento de destino anterior quando o destino do arrastamento muda; o evento também pode ocorrer se a operação for cancelada. Não o confundas com dragend, que diz respeito à origem e ao fim do arrastamento. dragleave propaga-se para cima na árvore e não pode ser cancelado: preventDefault() não pode impedir a saída do destino. Com elementos aninhados, tem em conta os eventos originados por elementos descendentes.
O atributo HTML contém código sob a forma de texto; à propriedade element.ondragleave atribui-se uma função ou null. Outra opção é addEventListener('dragleave', handler). Uma Content Security Policy pode bloquear código nos atributos.
O exemplo envia deliberadamente um evento sintético quando se clica em Test, tornando o resultado repetível sem arrastar com o rato. Verifica a execução do processador do evento, não o mecanismo nativo de arrastar e largar.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragleave test</title>
<div id="zone" ondragleave="this.textContent = 'dragleave received'">Waiting</div>
<button type="button" id="test">Test</button>
<script>
const zone = document.getElementById('zone');
document.getElementById('test').addEventListener('click', () => {
zone.dispatchEvent(new DragEvent('dragleave', {
bubbles: true,
cancelable: false
}));
});
</script>
</html>Resultado
dragleave received
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.