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

CKTIS / HTML

ondragenter — tratar a entrada de um elemento arrastado

O atributo ondragenter define o código JavaScript executado no evento dragenter quando um elemento arrastado chega a um elemento de destino. Permite reagir à entrada no destino, mas não trata a ação de largar o elemento.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

ondragenter="JavaScript statements"

ondragenter é um atributo de tratamento do evento dragenter, disponível nos elementos HTML. O seu valor contém instruções JavaScript, e não apenas o nome de uma função: para chamar uma função, são necessários parênteses. No código do atributo, event refere-se ao evento fornecido. A propriedade JavaScript correspondente, element.ondragenter, aceita uma função ou null.

dragenter indica que um elemento arrastado chegou a um destino; não significa que tenha sido largado. O evento propaga-se para cima na árvore e pode ser cancelado. No modelo de processamento da norma HTML, cancelar dragenter é uma das formas de definir o destino atual da operação de arrastar e largar. Na prática, os navegadores atuais não exigem que se cancele dragenter para que o elemento possa ser largado. Para permitir que um elemento seja largado num destino personalizado, chama event.preventDefault() no gestor de dragover e trata a ação de largar no gestor de drop. Ao contrário de ondragenter, ondragover é executado repetidamente enquanto o elemento permanece sobre o destino.

O exemplo envia um evento dragenter sintético para que o resultado possa ser repetido sem arrastar manualmente. Ao clicar em Run test, o resultado é dragenter: true. Isto confirma apenas que a chamada a event.preventDefault() no código do atributo cancelou o evento enviado. O teste não verifica um arrastamento real, se é possível largar o elemento no destino, nem a transferência de dados. As políticas de segurança da página podem bloquear código nos atributos; uma alternativa é addEventListener('dragenter', handler).

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragenter demo</title>
<div id="target" ondragenter="event.preventDefault(); document.getElementById('result').textContent = event.type + ': ' + event.defaultPrevented;">Target</div>
<button id="test" type="button">Run test</button>
<output id="result"></output>
<script>
  document.getElementById('test').addEventListener('click', () => {
    document.getElementById('target').dispatchEvent(
      new DragEvent('dragenter', { bubbles: true, cancelable: true })
    );
  });
</script>
</html>

Resultado

dragenter: true

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