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.