Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DataTransfer: podaci i dopuštene radnje pri povlačenju

DataTransfer prenosi podatke tijekom povlačenja. Saznajte kako effectAllowed ograničava radnje na izvoru, setData() pohranjuje podatke, a dropEffect odabire radnju na odredištu, bez samostalnog kopiranja ili premještanja.

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

DataTransfer je sučelje Web API-ja, a ne dio samog ECMAScripta. Tijekom povlačenja dostupno je kao event.dataTransfer. Koriste ga i druga sučelja, primjerice sučelja međuspremnika, ali svojstva radnji povlačenja ondje nemaju istu ulogu. Prisutnost Node 24 ne dokazuje podršku preglednika za ovaj API; primjer zahtijeva preglednik koji podržava izvorni HTML Drag and Drop.

DataTransfer.setData(format, data) pohranjuje tekst pod navedenom vrstom, primjerice text/plain, i vraća undefined. Prema standardu HTML-a, pri ponovnom zapisivanju podataka iste vrste prethodna se stavka uklanja, a nova se dodaje na kraj popisa, što može promijeniti redoslijed vrsta. Pri stvarnom povlačenju podatke zapišite u dragstart, a pročitajte ih pomoću getData() u drop.

DataTransfer.effectAllowed određuje radnje koje izvor dopušta i treba ga postaviti u dragstart. Vrijednosti su none, copy, copyLink, copyMove, link, linkMove, move, all i zadana vrijednost uninitialized, koja dopušta sve radnje. Odredište odabire kompatibilnu radnju putem DataTransfer.dropEffect: none, copy, link ili move. Nevažeće vrijednosti oba svojstva zanemaruju se.

U dragover pozovite preventDefault() kako biste omogućili ispuštanje i postavite dropEffect pri svakom događaju. To utječe na povratnu informaciju, obično pokazivač, ali samo po sebi ne kopira niti briše podatke. Aplikacija provodi takvo ponašanje: primjer čita tekst u drop i prikazuje ga pomoću textContent, bez tumačenja kao HTML-a. Učinak move zahtijevao bi i obradu uklanjanja podataka iz izvora.

Primjeri

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

Rezultat

Copied: CKTIS

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori