CKTIS / HTML
ondragstart — gestire l’inizio del trascinamento
L’attributo ondragstart definisce il codice JavaScript eseguito per l’evento dragstart quando inizia un trascinamento. Permette di preparare i dati dell’operazione o di annullarne l’avvio; da solo non rende trascinabile un elemento.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondragstart="JavaScript statements"ondragstart è un attributo gestore di eventi disponibile sugli elementi HTML. Il suo valore è codice JavaScript, non un valore booleano. Gestisce dragstart all’inizio di un’operazione di trascinamento, non a ogni movimento del puntatore.
Nel codice dell’attributo, event indica l’oggetto DragEvent. Durante un dragstart nativo, l’archivio dei dati di trascinamento è leggibile e scrivibile: event.dataTransfer.setData('text/plain', 'Hello') imposta il testo trasferito. Chiamare event.preventDefault() o eseguire return false in questo gestore annulla l’avvio del trascinamento.
ondragstart da solo non abilita il trascinamento. Per un normale elemento sorgente, si può impostare draggable="true". ondragstart è anche il nome di una proprietà JavaScript che accetta una funzione; con addEventListener, il nome dell’evento è dragstart, senza il prefisso on.
L’esempio annulla intenzionalmente l’operazione dopo aver modificato il messaggio di stato. Mostra come gestire l’inizio del trascinamento, non un’implementazione completa del rilascio.
Esempi
<!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>Risultato
dragstart: canceled
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.