Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DataTransfer: dati e operazioni consentite nel trascinamento

DataTransfer trasporta dati durante il trascinamento. Scopri come effectAllowed limita le operazioni alla sorgente, setData() memorizza i dati e dropEffect seleziona l’operazione alla destinazione, senza eseguire da sé la copia o lo spostamento.

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

event.dataTransfer.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";

DataTransfer è un’interfaccia della Web API, non fa parte di ECMAScript. Durante il trascinamento è disponibile come event.dataTransfer. La usano anche altre interfacce, come quelle degli appunti, ma le proprietà relative alle operazioni di trascinamento non hanno lì lo stesso ruolo. La presenza di Node 24 non dimostra il supporto del browser per questa API; l’esempio richiede un browser che supporti il trascinamento HTML nativo.

DataTransfer.setData(format, data) memorizza testo sotto un tipo specificato, ad esempio text/plain, e restituisce undefined. Secondo lo standard HTML, quando si scrivono di nuovo dati dello stesso tipo, l’elemento precedente viene rimosso e quello nuovo viene aggiunto in fondo all’elenco. Questo può cambiare l’ordine dei tipi. In un trascinamento reale, scrivi i dati in dragstart e leggili con getData() in drop.

DataTransfer.effectAllowed specifica le operazioni consentite dalla sorgente e va impostato in dragstart. I valori sono none, copy, copyLink, copyMove, link, linkMove, move, all e il valore predefinito uninitialized, che consente tutte le operazioni. La destinazione sceglie un’operazione compatibile tramite DataTransfer.dropEffect: none, copy, link o move. I valori non validi di entrambe le proprietà vengono ignorati.

In dragover, chiama preventDefault() per consentire il rilascio e imposta dropEffect a ogni evento. La proprietà influenza il riscontro visivo, di solito il cursore, ma da sola non copia né elimina dati. È l’applicazione a implementare il comportamento: l’esempio legge il testo in drop e lo mostra tramite textContent, senza interpretarlo come HTML. Un effetto move richiederebbe anche di gestire la rimozione dei dati dalla sorgente.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>DataTransfer copy</title>
<p id="source" draggable="true">Drag this text</p>
<div id="target" style="border: 2px dashed; padding: 2rem">Drop here</div>
<pre id="output" aria-live="polite"></pre>
<script>
  const source = document.getElementById("source");
  const target = document.getElementById("target");
  const output = document.getElementById("output");
  let localDrag = false;

  source.addEventListener("dragstart", (event) => {
    localDrag = true;
    event.dataTransfer.setData("text/plain", "CKTIS");
    event.dataTransfer.effectAllowed = "copy";
  });

  source.addEventListener("dragend", () => {
    localDrag = false;
  });

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

  target.addEventListener("drop", (event) => {
    if (!localDrag) return;
    event.preventDefault();
    const text = event.dataTransfer.getData("text/plain");
    target.textContent = text;
    output.textContent = `Copied: ${text}`;
  });
</script>
</html>

Risultato

Copied: CKTIS

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.

Fonti