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

CKTIS / JavaScript

DataTransfer: data při přetahování a povolené operace

DataTransfer přenáší data během přetahování. Zjistěte, jak effectAllowed omezuje operace na zdroji, setData() ukládá data a dropEffect vybírá operaci v cíli, aniž by samo provedlo kopírování či přesun.

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.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";

DataTransfer je rozhraní Web API, nikoli součást samotného ECMAScriptu. Během přetahování je dostupné jako event.dataTransfer. Používají ho i jiná rozhraní, například rozhraní schránky, ale vlastnosti operací přetahování tam nemají stejnou úlohu. Samotná přítomnost Node 24 nedokazuje podporu tohoto API v prohlížeči; příklad vyžaduje prohlížeč podporující nativní HTML Drag and Drop.

DataTransfer.setData(format, data) ukládá text pod zadaným typem, například text/plain, a vrací undefined. Při opětovném zápisu dat stejného typu se podle standardu HTML původní položka odstraní a nová se přidá na konec seznamu, což může změnit pořadí typů. Při skutečném přetahování zapisujte data v dragstart a čtěte je pomocí getData() v drop.

DataTransfer.effectAllowed určuje operace povolené zdrojem a má se nastavit v dragstart. Jeho hodnoty jsou none, copy, copyLink, copyMove, link, linkMove, move, all a výchozí uninitialized, která povoluje všechny operace. Cíl vybere kompatibilní operaci pomocí DataTransfer.dropEffect: none, copy, link nebo move. Neplatné hodnoty obou vlastností se ignorují.

V dragover zavolejte preventDefault(), aby bylo možné data pustit, a při každé události nastavte dropEffect. Ovlivňuje zpětnou vazbu, obvykle kurzor, ale sama data nekopíruje ani nemaže. Toto chování zajišťuje aplikace: příklad čte text v drop a zobrazuje ho přes textContent, aniž by ho interpretoval jako HTML. Efekt move by vyžadoval také zpracování odebrání dat ze zdroje.

Příklady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>DataTransfer copy</title>
<p id="source" draggable="true">Drag this text</p>
<div id="target" style="border: 2px dashed; padding: 2rem">Drop here</div>
<pre id="output" aria-live="polite"></pre>
<script>
  const source = document.getElementById("source");
  const target = document.getElementById("target");
  const output = document.getElementById("output");
  let localDrag = false;

  source.addEventListener("dragstart", (event) => {
    localDrag = true;
    event.dataTransfer.setData("text/plain", "CKTIS");
    event.dataTransfer.effectAllowed = "copy";
  });

  source.addEventListener("dragend", () => {
    localDrag = false;
  });

  target.addEventListener("dragover", (event) => {
    if (!localDrag) return;
    event.preventDefault();
    event.dataTransfer.dropEffect = "copy";
  });

  target.addEventListener("drop", (event) => {
    if (!localDrag) return;
    event.preventDefault();
    const text = event.dataTransfer.getData("text/plain");
    target.textContent = text;
    output.textContent = `Copied: ${text}`;
  });
</script>
</html>

Výsledek

Copied: CKTIS

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