Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Eventi HTML dragstart, dragover, drop e dragend

Distingui gli eventi dell’origine da quelli della destinazione per impostare i dati, accettare il rilascio, leggere il contenuto e ripristinare lo stato anche in caso di annullamento.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);

Questi eventi appartengono all’API HTML di trascinamento del browser, non a ECMAScript. dragstart si verifica sull’origine, per esempio un elemento con draggable="true". Nel relativo gestore sincrono puoi leggere i dati e scriverli con event.dataTransfer.setData(type, text). L’origine imposta le operazioni consentite con effectAllowed. Chiamare preventDefault() su dragstart impedisce l’avvio del trascinamento.

dragover si verifica più volte sopra una possibile destinazione. Se la destinazione accetta il trascinamento, chiama preventDefault() su dragover e, se serve, imposta dropEffect su un’operazione consentita dall’origine. In modalità protetta puoi consultare i formati con dataTransfer.types, ma non leggere i dati. L’esempio annulla anche dragenter per seguire il modello dello standard; nei browser più diffusi, per una zona come questa di solito basta annullare dragover.

drop si verifica sulla destinazione quando i dati vengono rilasciati in un punto che li accetta. Per gestire il rilascio in modo personalizzato, chiama preventDefault() per impedire l’azione predefinita e leggi i dati in modo sincrono con getData(type). Se il formato manca, ottieni una stringa vuota. Considera il contenuto rilasciato non attendibile: usa textContent, non innerHTML, per visualizzare testo semplice.

dragend si verifica sull’origine quando termina un trascinamento avviato, anche se è stato annullato o il rilascio non è riuscito. Ripristina qui lo stato temporaneo: l’evento da solo non indica un esito positivo. Se dropEffect vale "none", non è avvenuta alcuna operazione di rilascio. Se trascini un file dal sistema operativo, la pagina non riceve gli eventi dell’origine. Il supporto varia a seconda del browser e del metodo di input; offri un modo per eseguire l’azione senza trascinare.

Esempi

(() => {
  const panel = document.createElement("section");
  panel.style.cssText = "position:fixed;top:16px;left:16px;z-index:1000;padding:16px;background:white;color:black;display:flex;gap:16px";
  const source = document.createElement("div");
  const target = document.createElement("div");
  source.draggable = true;
  source.textContent = "Drag this card";
  source.style.cssText = "padding:16px;border:1px solid;cursor:grab";
  target.textContent = "Drop here";
  target.style.cssText = "padding:16px;border:2px dashed;min-width:100px";
  panel.append(source, target);
  document.body.append(panel);

  let active = false;
  const accepts = (event) => active && event.dataTransfer?.types.includes("text/plain");

  source.addEventListener("dragstart", (event) => {
    const transfer = event.dataTransfer;
    transfer.setData("text/plain", "Card");
    transfer.effectAllowed = "copy";
    active = true;
    source.style.opacity = "0.5";
    console.log("dragstart");
  });

  target.addEventListener("dragenter", (event) => {
    if (accepts(event)) event.preventDefault();
  });

  target.addEventListener("dragover", (event) => {
    if (!accepts(event)) return;
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  });

  target.addEventListener("drop", (event) => {
    if (!accepts(event)) return;
    event.preventDefault();
    const text = event.dataTransfer.getData("text/plain");
    target.textContent = text;
    console.log(`drop: ${text}`);
  });

  source.addEventListener("dragend", () => {
    active = false;
    source.style.opacity = "";
    console.log("dragend");
  });

  // Exercise the same handlers once without a pointer gesture.
  const transfer = new DataTransfer();
  const dispatch = (element, type) => element.dispatchEvent(new DragEvent(type, {
    bubbles: true,
    cancelable: type !== "dragend",
    dataTransfer: transfer,
  }));

  if (dispatch(source, "dragstart")) {
    dispatch(target, "dragenter");
    // dispatchEvent returns false when the handler cancels dragover.
    if (!dispatch(target, "dragover")) dispatch(target, "drop");
    dispatch(source, "dragend");
  }
})();

Risultato

dragstart
drop: Card
dragend

Esegui il codice nella console del browser su una scheda vuota. Il codice attiva una volta i gestori tramite eventi sintetici, senza che tu debba trascinare nulla, e la destinazione mostra `Card`. Per provare il trascinamento nativo, trascina «Drag this card» sulla destinazione. Premendo Esc durante un altro trascinamento, lo termini senza `drop`. Gli eventi `dragover` ripetuti non vengono registrati.

Lezioni correlate

  • JavaScript · Lezione 34 · Intermedio · Versione: 3

Fonti