CKTIS / HTML
ondrop — gestire i dati rilasciati
L’attributo ondrop definisce il codice JavaScript che gestisce l’evento drop durante il trascinamento e rilascio. Da solo non crea una destinazione di rilascio: di solito è necessario annullare anche la gestione predefinita di dragover.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop è un attributo globale HTML per la gestione degli eventi e può comparire su qualsiasi elemento HTML. Il suo valore è codice JavaScript eseguito quando viene ricevuto un evento drop, cioè quando i dati vengono rilasciati su una destinazione accettata. L’oggetto event espone l’evento e event.dataTransfer espone i dati trasferiti.
Un gestore ondrop da solo non definisce una normale destinazione di rilascio. Nel gestore dragover, chiama event.preventDefault() per consentire il rilascio. L’esempio annulla anche dragenter. Nel gestore drop, usa di nuovo event.preventDefault() per prendere in carico l’azione predefinita e leggi il testo con event.dataTransfer.getData('text/plain').
Distingui l’attributo HTML ondrop, il cui valore è testo sorgente, dalla proprietà DOM element.ondrop, a cui si assegna una funzione o null. Il nome dell’evento è drop, non ondrop; con addEventListener si usa drop. Assegnare di nuovo element.ondrop sostituisce la funzione precedente registrata tramite questo meccanismo.
L’esempio trasferisce il testo fisso Hello e lo mostra tramite textContent, senza interpretare i dati come HTML. Richiede un ambiente che consenta gli script e i gestori di eventi inline; le restrizioni di sicurezza del documento possono bloccarli.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>Risultato
Hello
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.