CKTIS / JavaScript
DragEvent.dataTransfer — podatki vlečenja
DragEvent.dataTransfer izpostavi objekt DataTransfer dogodka vlečenja. Dostop do njegovih podatkov je odvisen od faze dejanja; dogodek, ustvarjen s skriptom, lahko vrne null.
Različica: 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 je lastnost samo za branje, ki vrne DataTransfer ali null. Brskalnik pripne objekt izvornim dogodkom vlečenja. Pri new DragEvent("drop") je dataTransfer privzeto null; konstruktorju lahko podamo izrecen objekt. Samo sklic je samo za branje, ne pa celotna vsebina objekta.
Pri izvornem vlečenju lahko med dragstart podatke zapišemo z setData(). Med drop jih lahko preberemo z getData(), ne moremo pa jih spreminjati. Pri drugih dogodkih tega postopka je shramba podatkov v zaščitenem načinu: oblike lahko preverimo prek types, vendar getData() vrne prazen niz. files izpostavi datoteke, items pa podatkovne elemente.
Če s skriptom ustvarimo dogodek dragover in mu podamo nov objekt DataTransfer, shramba zato ne preide v zaščiteni način. getData() lahko še vedno vrne podatke, zapisane z setData().
Da navaden element sprejme spuščanje, prekliči dragover z preventDefault(). Pri izvornem vlečenju podatke preberi sinhrono v obravnavalniku drop, preden se dostop do shrambe konča. Potrebne vrednosti kopiraj pred asinhrono obdelavo.
To je brskalniški API, določen s standardom HTML, ne funkcija določene izdaje ECMAScript. Razpoložljivost v Node 24 ne potrjuje podpore v brskalnikih. Primer zahteva konstruktorja DragEvent in DataTransfer; ustvarjanje dogodka s skriptom ne sproži izvornega vlečenja.
Primeri
(() => {
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.