Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti