CKTIS / JavaScript
DragEvent.dataTransfer — podaci povlačenja
DragEvent.dataTransfer izlaže objekt DataTransfer događaja povlačenja. Pristup njegovim podacima ovisi o fazi radnje; događaj stvoren skriptom može vratiti null.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
event.dataTransfer // DataTransfer | nullDragEvent.dataTransfer svojstvo je samo za čitanje koje vraća DataTransfer ili null. Preglednik pridružuje objekt izvornim događajima povlačenja. U slučaju new DragEvent("drop"), dataTransfer je prema zadanim postavkama null; konstruktoru se može proslijediti izričit objekt. Samo je referenca samo za čitanje, a ne cjelokupan sadržaj objekta.
Pri izvornom povlačenju podaci se tijekom dragstart mogu zapisati pomoću setData(). Tijekom drop mogu se pročitati pomoću getData(), ali ne i mijenjati. Pri ostalim događajima te radnje spremište podataka radi u zaštićenom načinu rada: formati se mogu provjeriti putem types, no getData() vraća prazan niz. files izlaže datoteke, a items podatkovne stavke.
Stvaranje događaja dragover skriptom i prosljeđivanje novog objekta DataTransfer tom događaju ne prebacuje spremište u zaštićeni način rada. getData() i dalje može vratiti podatke zapisane pomoću setData().
Da bi običan element prihvatio ispuštanje, otkaži dragover pomoću preventDefault(). Pri izvornom povlačenju podatke pročitaj sinkrono u rukovatelju događaja drop, prije nego što pristup spremištu završi. Potrebne vrijednosti kopiraj prije asinkronog rada.
Ovo je API preglednika definiran standardom HTML, a ne značajka određene edicije ECMAScripta. Dostupnost u Nodeu 24 ne dokazuje podršku u preglednicima. Primjer zahtijeva konstruktore DragEvent i DataTransfer; stvaranje događaja skriptom ne pokreće izvorno povlačenje.
Primjeri
(() => {
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);
})();Rezultat
true CKTIS true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.