Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

ondrag — gestire gli eventi di trascinamento

L’attributo ondrag contiene JavaScript che gestisce l’evento drag, inviato ripetutamente all’origine durante il trascinamento. L’attributo da solo non rende un elemento trascinabile e non definisce una destinazione di rilascio.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

<element ondrag="JavaScript statements"></element>

ondrag è un attributo gestore di eventi disponibile su tutti gli elementi HTML. Il suo valore è codice JavaScript eseguito quando viene ricevuto un evento drag. Nel codice dell’attributo, il parametro event fornisce l’oggetto evento. Esiste anche la proprietà JavaScript corrispondente, element.ondrag.

Durante il trascinamento nativo, il browser invia periodicamente drag al nodo di origine. Non è un evento per ogni movimento del puntatore; non dare per scontata una frequenza fissa. Per consentire il trascinamento di un elemento normale, imposta draggable="true" — ondrag da solo non lo fa.

Distingui ondragstart (inizio), ondrag (trascinamento in corso), ondragover (trascinamento sopra una possibile destinazione), ondrop (rilascio) e ondragend (fine). ondrag non sostituisce la gestione della destinazione di rilascio. Imposta i dati del trascinamento in dragstart; durante drag, l’archivio dati è in modalità protetta, quindi il contenuto dei dati non è disponibile.

L’esempio cambia il testo di stato in drag received quando viene ricevuto drag. Gli eventi successivi mantengono lo stesso testo, perciò il risultato atteso non dipende dal loro numero. Salva il file HTML, aprilo in un browser e trascina Drag me.

Esempi

<!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>

Risultato

ready → drag received

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