Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DragEvent.dataTransfer — data přetahování

DragEvent.dataTransfer zpřístupňuje objekt DataTransfer události přetahování. Přístup k jeho datům závisí na fázi operace; událost vytvořená skriptem může vrátit null.

Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

event.dataTransfer // DataTransfer | null

DragEvent.dataTransfer je vlastnost pouze pro čtení, která vrací DataTransfer nebo null. Prohlížeč připojuje objekt k nativním událostem přetahování. U new DragEvent("drop") je dataTransfer ve výchozím nastavení null; konstruktoru lze předat konkrétní objekt. Pouze odkaz je jen pro čtení, nikoli celý obsah objektu.

Při nativním přetahování lze během dragstart zapisovat data pomocí setData(). Během drop je lze číst pomocí getData(), ale nelze je měnit. Při ostatních událostech této operace je úložiště dat v chráněném režimu: formáty lze zkontrolovat přes types, ale getData() vrací prázdný řetězec. files zpřístupňuje soubory a items datové položky.

Vytvořením události dragover ve skriptu a předáním nového objektu DataTransfer se úložiště nepřepne do chráněného režimu. getData() může stále vrátit data zapsaná pomocí setData().

Aby běžný prvek přijímal přetažení, zruš událost dragover pomocí preventDefault(). Při nativním přetahování přečti data synchronně v obsluze drop, než přístup k úložišti skončí. Potřebné hodnoty zkopíruj před asynchronním zpracováním.

Jde o rozhraní prohlížeče definované standardem HTML, nikoli o funkci konkrétní verze ECMAScriptu. Dostupnost v Node 24 nedokládá podporu v prohlížečích. Příklad vyžaduje konstruktory DragEvent a DataTransfer; vytvoření události ve skriptu nespustí nativní přetahování.

Pří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ýsledek

true
CKTIS
true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje