CKTIS / HTML
ondragleave — gestire l’uscita da una destinazione di trascinamento
L’attributo ondragleave contiene codice JavaScript che gestisce l’evento dragleave. Può, per esempio, rimuovere l’evidenziazione dalla destinazione precedente durante un trascinamento; non indica che l’intera operazione di trascinamento sia terminata.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
ondragleave="JavaScript statements"ondragleave è un attributo per la gestione degli eventi disponibile sugli elementi HTML. Il suo valore è il corpo di una funzione JavaScript, non il nome di un evento né un valore booleano. Corrisponde all’evento dragleave; nel codice dell’attributo, event rappresenta l’evento e this indica l’elemento che lo gestisce.
Il browser invia dragleave all’elemento di destinazione precedente quando cambia la destinazione del trascinamento; l’evento può verificarsi anche quando l’operazione viene annullata. Non confonderlo con dragend, che riguarda la sorgente e la fine del trascinamento. dragleave si propaga verso l’alto nell’albero e non è annullabile: preventDefault() non può impedire di lasciare la destinazione. Con elementi annidati, considera gli eventi provenienti dagli elementi discendenti.
L’attributo HTML contiene codice come testo; alla proprietà element.ondragleave si assegna una funzione o null. Un’altra opzione è addEventListener('dragleave', handler). Una Content Security Policy può bloccare il codice negli attributi.
L’esempio invia intenzionalmente un evento sintetico quando si fa clic su Test, così il risultato è ripetibile senza trascinare con il mouse. Verifica l’esecuzione del gestore, non il meccanismo nativo di trascinamento e rilascio.
Esempi
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragleave test</title>
<div id="zone" ondragleave="this.textContent = 'dragleave received'">Waiting</div>
<button type="button" id="test">Test</button>
<script>
const zone = document.getElementById('zone');
document.getElementById('test').addEventListener('click', () => {
zone.dispatchEvent(new DragEvent('dragleave', {
bubbles: true,
cancelable: false
}));
});
</script>
</html>Risultato
dragleave 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.