CKTIS / HTML
ondragend — gestire la fine di un trascinamento
L’attributo ondragend esegue JavaScript quando termina un’operazione di trascinamento, anche se viene annullata o il rilascio non riesce. È utile per ripulire lo stato dell’elemento sorgente, non per confermare che una destinazione abbia accettato i dati.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondragend="JavaScript statements"ondragend è un attributo di contenuto gestore di eventi per dragend, consentito su ogni elemento HTML. Il suo valore è codice JavaScript, non un valore booleano. Nel codice dell’attributo, il parametro event fornisce l’oggetto evento. L’attributo non abilita da solo il trascinamento; l’esempio usa draggable="true" a questo scopo.
L’evento dragend viene inviato alla sorgente quando termina l’operazione di trascinamento, anche in caso di annullamento o di rilascio rifiutato. A differenza di drop, non è l’evento che segnala l’accettazione dei dati da parte della destinazione. È utile per rimuovere gli indicatori visivi del trascinamento. Controlla event.dataTransfer.dropEffect per verificare il risultato dell’operazione; none significa che non è stata eseguita alcuna operazione.
In JavaScript puoi anche assegnare una funzione alla proprietà element.ondragend o registrare un listener con element.addEventListener('dragend', handler). Il nome dell’evento è dragend, senza il prefisso on. La Content Security Policy può bloccare il codice scritto direttamente in un attributo; in quell’ambiente, usa uno script consentito con addEventListener.
L’esempio imposta il testo di stato su Drag ended, indipendentemente dal successo del rilascio. Non implementa una destinazione di rilascio né il trasferimento di dati.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
ondragend="document.getElementById('status').textContent = 'Drag ended'">
Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>Risultato
Drag ended
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.