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

CKTIS / HTML

ondragover — tratar o arrastamento sobre um elemento

O atributo ondragover contém código JavaScript que trata eventos dragover enquanto um elemento é arrastado sobre um destino. Cancelar o evento com event.preventDefault() permite que um elemento comum aceite uma operação de largar.

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

Sintaxe

ondragover="event.preventDefault()"

ondragover é o atributo de conteúdo do controlador do evento dragover. O seu valor é código JavaScript, não um valor booleano. O controlador pode aceder a event; o evento é acionado repetidamente enquanto se arrasta sobre um destino, e não apenas quando se entra nele.

Para um destino de largada comum, chama event.preventDefault() ao tratar dragover. Cancelar o evento assinala que a operação é aceite; definir apenas event.dataTransfer.dropEffect não é suficiente. O valor de dropEffect, como copy, tem de ser compatível com effectAllowed da origem. Alguns elementos editáveis têm um comportamento predefinido para largar texto.

ondragover não lê nem insere automaticamente o conteúdo arrastado. Lê os dados com getData() no controlador drop; durante dragover, o armazenamento de dados está em modo protegido. No exemplo, dragstart guarda texto, dragenter e dragover cancelam os respetivos eventos e drop atualiza o resultado com textContent.

Distingue o atributo da propriedade JavaScript element.ondragover, à qual se atribui uma função, e de addEventListener('dragover', handler), que regista um listener usando o nome do evento sem o prefixo on.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragover example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'HELLO'); event.dataTransfer.effectAllowed = 'copy'">Drag HELLO</p>
<div style="padding: 2rem; border: 2px dashed"
     ondragenter="event.preventDefault()"
     ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
     ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')">Drop here</div>
<p id="result" role="status">Waiting</p>
</html>

Resultado

HELLO

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