Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

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

Zdroje