CKTIS / HTML
ondrag — gerir eventos de arrastamento
O atributo ondrag contém JavaScript que gere o evento drag, enviado repetidamente à origem durante o arrastamento. O atributo, por si só, não torna um elemento arrastável nem define um destino de largada.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<element ondrag="JavaScript statements"></element>ondrag é um atributo de tratamento de eventos disponível em todos os elementos HTML. O seu valor é código JavaScript executado quando é recebido um evento drag. No código do atributo, o parâmetro event disponibiliza o objeto do evento. Existe também a propriedade JavaScript correspondente, element.ondrag.
Durante o arrastamento nativo, o navegador envia periodicamente drag ao nó de origem. Este evento não ocorre a cada movimento do ponteiro; não suponha uma frequência fixa. Para permitir o arrastamento de um elemento normal, defina draggable="true" — ondrag, por si só, não o faz.
Distinga ondragstart (início), ondrag (arrastamento em curso), ondragover (arrastamento sobre um destino potencial), ondrop (largada) e ondragend (fim). ondrag não substitui o tratamento do destino de largada. Defina os dados do arrastamento em dragstart; durante drag, o armazenamento de dados está em modo protegido, pelo que o conteúdo dos dados não está disponível.
O exemplo altera o texto de estado para drag received quando recebe drag. Os eventos seguintes mantêm o mesmo texto, pelo que o resultado esperado não depende da quantidade de eventos. Guarde o ficheiro HTML, abra-o num navegador e arraste Drag me.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>Resultado
ready → drag 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.