Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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

DragEvent.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.

Viri