CKTIS / HTML
ondragstart — gerir o início do arrastamento
O atributo ondragstart define o código JavaScript executado quando ocorre o evento dragstart, no início de um arrastamento. Permite preparar os dados da operação ou cancelar o seu início; por si só, não torna um elemento arrastável.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
ondragstart="JavaScript statements"ondragstart é um atributo de tratamento de eventos disponível nos elementos HTML. O seu valor é código JavaScript, não um valor booleano. Trata o evento dragstart no início de uma operação de arrastamento, e não em cada movimento do ponteiro.
No código do atributo, event representa o objeto DragEvent. Durante um dragstart nativo, o armazenamento de dados do arrastamento pode ser lido e escrito: event.dataTransfer.setData('text/plain', 'Hello') define o texto transferido. Chamar event.preventDefault() ou executar return false neste manipulador cancela o início do arrastamento.
ondragstart não ativa o arrastamento por si só. Para um elemento de origem comum, pode definir-se draggable="true". ondragstart é também o nome de uma propriedade JavaScript que aceita uma função; com addEventListener, o nome do evento é dragstart, sem o prefixo on.
O exemplo cancela deliberadamente a operação depois de alterar a mensagem de estado. Demonstra o tratamento do início do arrastamento, não uma implementação completa da ação de largar.
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragstart example</title>
<p draggable="true"
ondragstart="document.getElementById('status').textContent = 'dragstart: canceled'; event.preventDefault();">
Drag this text.
</p>
<p id="status" role="status">Ready</p>
</html>Resultado
dragstart: canceled
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.