CKTIS / JavaScript
Eventi del ciclo di trascinamento HTML
Scopri i sette eventi di trascinamento HTML, come sono ripartiti tra origine e destinazione e quando DataTransfer può essere letto o modificato. Capisci perché dragover richiede preventDefault() e perché dragend non dimostra che il rilascio sia riuscito.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
source.addEventListener("dragstart", handler);
source.addEventListener("drag", handler);
source.addEventListener("dragend", handler);
target.addEventListener("dragenter", handler);
target.addEventListener("dragover", handler);
target.addEventListener("dragleave", handler);
target.addEventListener("drop", handler);Gli eventi del ciclo di trascinamento HTML sono sette eventi dell’API HTML Drag and Drop del browser, non una funzionalità di una specifica edizione di ECMAScript. L’origine riceve dragstart all’inizio del trascinamento, eventi drag ripetuti durante il trascinamento e dragend al termine. Le potenziali destinazioni ricevono dragenter all’ingresso, eventi dragover ripetuti, dragleave all’uscita e drop quando un elemento viene rilasciato su una destinazione valida. Il numero e la frequenza delle ripetizioni non sono fissi.
Rendi trascinabile un elemento normale con draggable = true. In dragstart, scrivi testo usando event.dataTransfer.setData(). I dati possono essere modificati solo in dragstart e il loro contenuto può essere letto in dragstart e drop; in dragover, controlla i tipi disponibili invece del contenuto. In pratica, nei browser basta chiamare preventDefault() in dragover quando una destinazione personalizzata accetta i dati trascinati. Lo standard HTML richiede però di annullare anche dragenter affinché un elemento normale venga selezionato come destinazione di rilascio personalizzata. In drop, annulla anche il comportamento predefinito e leggi i dati con getData().
Usa dragend per la pulizia anche quando il gesto viene annullato, ad esempio con Escape; la sua occorrenza non dimostra che l’operazione sia riuscita. effectAllowed definisce le operazioni consentite dall’origine, mentre dropEffect indica quella selezionata; nessuno dei due sposta automaticamente elementi DOM. Considera non attendibili i dati esterni: verifica i valori e visualizza il testo con textContent.
L’esempio copia solo token-1 e offre un pulsante come alternativa al trascinamento. Prova un gesto reale nel browser di destinazione: un DragEvent sintetico non riproduce l’intera operazione gestita dal browser. Trascinare un file dal sistema operativo non attiva nella pagina gli eventi dragstart o dragend sul lato dell’origine. La disponibilità di Node 24 non dimostra il supporto di queste interfacce del browser.
Esempi
const panel = document.createElement("section");
const source = document.createElement("p");
const target = document.createElement("p");
const alternative = document.createElement("button");
const output = document.createElement("p");
source.textContent = "Drag token-1";
source.draggable = true;
target.textContent = "Drop here";
target.style.cssText = "padding: 2rem; border: 2px dashed;";
alternative.type = "button";
alternative.textContent = "Copy token-1 without dragging";
output.setAttribute("role", "status");
output.textContent = "Ready";
panel.append(source, target, alternative, output);
document.body.append(panel);
function accept(value) {
if (value === "token-1") {
output.textContent = `Dropped: ${value}`;
}
}
source.addEventListener("dragstart", (event) => {
event.dataTransfer.setData("text/plain", "token-1");
event.dataTransfer.effectAllowed = "copy";
source.style.opacity = "0.5";
});
target.addEventListener("dragover", (event) => {
if (event.dataTransfer.types.includes("text/plain")) {
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
}
});
target.addEventListener("drop", (event) => {
event.preventDefault();
accept(event.dataTransfer.getData("text/plain"));
});
source.addEventListener("dragend", () => {
source.style.opacity = "";
});
alternative.addEventListener("click", () => accept("token-1"));Risultato
Dropped: token-1
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.