CKTIS / JavaScript
DataTransfer: podatki pri vlečenju in dovoljene operacije
DataTransfer prenaša podatke med vlečenjem. Spoznajte, kako effectAllowed omeji operacije na viru, setData() shrani podatke, dropEffect pa izbere operacijo na cilju, ne da bi samo izvedlo kopiranje ali premik.
Različica: 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 vmesnik Web API, ne del samega ECMAScripta. Med vlečenjem je na voljo kot event.dataTransfer. Uporabljajo ga tudi drugi vmesniki, na primer vmesniki za odložišče, vendar lastnosti za operacije vlečenja tam nimajo enake vloge. Prisotnost Node 24 ne dokazuje podpore tega API-ja v brskalniku; primer zahteva brskalnik, ki podpira izvorno HTML Drag and Drop.
DataTransfer.setData(format, data) shrani besedilo pod določeno vrsto, na primer text/plain, in vrne undefined. Pri ponovnem zapisu podatkov iste vrste se v skladu s standardom HTML prejšnji element odstrani, novi pa se doda na konec seznama. To lahko spremeni vrstni red vrst. Pri dejanskem vlečenju podatke zapišite v dragstart in jih preberite z getData() v drop.
DataTransfer.effectAllowed določa operacije, ki jih vir dovoljuje, in ga je treba nastaviti v dragstart. Vrednosti so none, copy, copyLink, copyMove, link, linkMove, move, all in privzeta uninitialized, ki dovoljuje vse operacije. Cilj izbere združljivo operacijo prek DataTransfer.dropEffect: none, copy, link ali move. Neveljavne vrednosti obeh lastnosti se prezrejo.
V dragover pokličite preventDefault(), da omogočite spuščanje, in ob vsakem dogodku nastavite dropEffect. Ta vpliva na povratno informacijo, običajno kazalec, vendar sam ne kopira ali izbriše podatkov. To vedenje izvede aplikacija: primer prebere besedilo v drop in ga prikaže z textContent, ne da bi ga razlagal kot HTML. Učinek move bi zahteval tudi obravnavo odstranitve podatkov iz vira.
Primeri
<!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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.