Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DragEvent.dataTransfer — dati di trascinamento

DragEvent.dataTransfer espone l’oggetto DataTransfer di un evento di trascinamento. L’accesso ai suoi dati dipende dalla fase dell’operazione; un evento creato da uno script può restituire null.

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 // DataTransfer | null

DragEvent.dataTransfer è una proprietà di sola lettura che restituisce DataTransfer oppure null. Il browser associa un oggetto agli eventi di trascinamento nativi. In new DragEvent("drop"), dataTransfer è null per impostazione predefinita; il costruttore accetta un oggetto esplicito. È il riferimento a essere di sola lettura, non l’intero contenuto dell’oggetto.

In un’operazione di trascinamento nativa, durante dragstart è possibile scrivere dati con setData(). Durante drop è possibile leggerli con getData(), ma non modificarli. Negli altri eventi dell’operazione, l’archivio dei dati è in modalità protetta: si possono controllare i formati tramite types, ma getData() restituisce una stringa vuota. files espone i file e items gli elementi di dati.

Creare un evento dragover tramite uno script e passargli un nuovo oggetto DataTransfer non mette l’archivio in modalità protetta. getData() può ancora restituire i dati scritti con setData().

Per fare in modo che un elemento normale accetti un rilascio, annulla dragover con preventDefault(). In un’operazione di trascinamento nativa, leggi i dati in modo sincrono nel gestore drop, prima che termini l’accesso all’archivio. Copia i valori necessari prima di svolgere attività asincrone.

Questa è un’API del browser definita da HTML, non una funzionalità di una particolare edizione di ECMAScript. La disponibilità in Node 24 non dimostra il supporto nei browser. L’esempio richiede i costruttori DragEvent e DataTransfer; creare un evento tramite script non avvia un trascinamento nativo.

Esempi

(() => {
  const transfer = new DataTransfer();
  transfer.setData("text/plain", "CKTIS");

  const event = new DragEvent("drop", { dataTransfer: transfer });
  const emptyEvent = new DragEvent("drop");

  console.log(event.dataTransfer === transfer);
  console.log(event.dataTransfer.getData("text/plain"));
  console.log(emptyEvent.dataTransfer === null);
})();

Risultato

true
CKTIS
true

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