CKTIS / JavaScript
DataTransfer: údaje pri ťahaní a povolené operácie
DataTransfer prenáša údaje počas ťahania. Zistite, ako effectAllowed obmedzuje operácie na zdroji, setData() ukladá údaje a dropEffect vyberá operáciu v cieli, pričom samo kopírovanie ani presun nevykoná.
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.setData(format, data);
event.dataTransfer.effectAllowed = "copyMove";
event.dataTransfer.dropEffect = "copy";DataTransfer je rozhranie Web API, nie súčasť samotného ECMAScriptu. Počas ťahania je dostupné ako event.dataTransfer. Používajú ho aj iné rozhrania, napríklad rozhrania schránky, no vlastnosti operácií ťahania tam nemajú rovnakú úlohu. Prítomnosť Node 24 sama osebe nedokazuje podporu tohto API v prehliadači; príklad vyžaduje prehliadač podporujúci natívne HTML Drag and Drop.
DataTransfer.setData(format, data) ukladá text pod zadaným typom, napríklad text/plain, a vracia undefined. Pri opätovnom zápise údajov rovnakého typu sa podľa štandardu HTML pôvodná položka odstráni a nová sa pridá na koniec zoznamu, čo môže zmeniť poradie typov. Pri skutočnom ťahaní zapisujte údaje v dragstart a čítajte ich pomocou getData() v drop.
DataTransfer.effectAllowed určuje operácie povolené zdrojom a má sa nastaviť v dragstart. Jeho hodnoty sú none, copy, copyLink, copyMove, link, linkMove, move, all a predvolená hodnota uninitialized, ktorá povoľuje všetky operácie. Cieľ vyberá kompatibilnú operáciu cez DataTransfer.dropEffect: none, copy, link alebo move. Neplatné hodnoty oboch vlastností sa ignorujú.
V dragover zavolajte preventDefault(), aby bolo možné údaje pustiť, a pri každej udalosti nastavte dropEffect. Ovplyvňuje spätnú väzbu, zvyčajne kurzor, ale samo údaje nekopíruje ani nemaže. Správanie implementuje aplikácia: príklad číta text v drop a zobrazuje ho cez textContent bez interpretácie ako HTML. Efekt move by vyžadoval aj spracovanie odstránenia údajov zo zdroja.
Prí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ýsledok
Copied: CKTIS
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.