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

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.

Fontes