CKTIS / JavaScript
DragEvent.dataTransfer — údaje presúvania
DragEvent.dataTransfer sprístupňuje objekt DataTransfer udalosti presúvania. Prístup k jeho údajom závisí od fázy operácie; udalosť vytvorená skriptom môže vrátiť null.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
event.dataTransfer // DataTransfer | nullDragEvent.dataTransfer je vlastnosť iba na čítanie, ktorá vracia DataTransfer alebo null. Prehliadač pripája objekt k natívnym udalostiam presúvania. Pri new DragEvent("drop") má dataTransfer predvolene hodnotu null; konštruktoru možno odovzdať konkrétny objekt. Iba odkaz je iba na čítanie, nie celý obsah objektu.
Pri natívnom presúvaní možno počas dragstart zapisovať údaje pomocou setData(). Počas drop ich možno čítať pomocou getData(), ale nie meniť. Pri ostatných udalostiach tejto operácie je úložisko údajov v chránenom režime: formáty možno skontrolovať cez types, no getData() vracia prázdny reťazec. files sprístupňuje súbory a items dátové položky.
Ak skript vytvorí udalosť dragover a odovzdá jej nový objekt DataTransfer, úložisko sa tým neprepne do chráneného režimu. getData() môže naďalej vrátiť údaje zapísané pomocou setData().
Ak má bežný prvok prijímať pustenie, zruš udalosť dragover pomocou preventDefault(). Pri natívnom presúvaní prečítaj údaje synchrónne v obsluhe drop, skôr než sa prístup k úložisku skončí. Potrebné hodnoty skopíruj pred asynchrónnym spracovaním.
Ide o rozhranie prehliadača definované štandardom HTML, nie o funkciu konkrétnej edície ECMAScriptu. Dostupnosť v Node 24 nedokazuje podporu v prehliadačoch. Príklad vyžaduje konštruktory DragEvent a DataTransfer; vytvorenie udalosti skriptom nespustí natívne presúvanie.
Príklady
(() => {
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);
})();Výsledok
true CKTIS true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.