CKTIS / JavaScript
DataTransfer: povolené operácie, efekt pustenia a údaje
Zdroj určí povolené operácie, cieľ jednu vyberie a `setData()` uloží text, ktorý môže cieľ pri pustení prečítať.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
// Source: write to this dragstart event's data store.
source.addEventListener("dragstart", (event) => {
const transfer = event.dataTransfer;
transfer.effectAllowed = "copyMove";
transfer.setData("text/plain", "card-34");
});
// Target: accept a compatible drag using this dragover event.
target.addEventListener("dragover", (event) => {
const transfer = event.dataTransfer;
if (!transfer.types.includes("text/plain")) return;
event.preventDefault();
transfer.dropEffect = "copy";
});
// Target: read from this drop event's data store.
target.addEventListener("drop", (event) => {
event.preventDefault();
const text = event.dataTransfer.getData("text/plain");
});event.dataTransfer sprístupňuje objekt DataTransfer udalosti presúvania myšou. Toto webové API definuje štandard HTML a nie je súčasťou ECMAScript 2024. Over si podporu v cieľovom prostredí.
Zdroj: nastav effectAllowed synchrónne v dragstart. Hodnoty copy, move a link povoľujú kopírovanie, presun a vytvorenie odkazu. copyLink, copyMove a linkMove povoľujú jednu z dvoch uvedených operácií, all povoľuje všetky tri a none žiadnu. Počiatočná hodnota uninitialized tiež povoľuje všetky tri, ale môže ovplyvniť predvolený výber. Neplatné hodnoty a zápisy mimo režimu čítania a zápisu sa ignorujú.
Cieľ: ak v dragover presúvanie prijímaš, zavolaj preventDefault() a nastav dropEffect na povolené copy, move alebo link. none znamená žiadnu operáciu; iné hodnoty sa ignorujú. Prehliadač určuje počiatočnú hodnotu pre dragenter a dragover podľa povolených operácií a zvyklostí platformy, napríklad podľa modifikačných klávesov. Nekompatibilný výber neumožní pustenie. Pri prijatom drop zavolaj preventDefault() a operáciu vykonaj vlastným kódom: samotné nastavenie move prvok DOM nepresunie.
Údaje: setData(format, data) prijíma dva reťazce a vracia undefined. Pridá text pre daný formát alebo nahradí existujúci text rovnakého formátu. Písmená ASCII v názve formátu sa menia na malé; text a url sú aliasy pre text/plain a text/uri-list. Ak do úložiska nemožno zapisovať, metóda nič nezmení.
Text zapisuj synchrónne v dragstart. V cieli ho čítaj synchrónne pomocou getData() v drop, keď je úložisko len na čítanie. Počas dragover môžeš skontrolovať types, ale nie čítať obsah. Na neskoršie použitie si ulož získaný reťazec, nie objekt udalosti. Pustené údaje považuj za nedôveryhodné a obyčajný text zobrazuj pomocou textContent.
Príklady
(() => {
const source = document.createElement("p");
source.textContent = "Drag card-34";
source.draggable = true;
source.style.cursor = "grab";
const target = document.createElement("div");
const prompt = "Drop here";
target.textContent = prompt;
target.style.cssText = "border: 2px dashed; padding: 24px;";
const format = "text/plain";
source.addEventListener("dragstart", (event) => {
event.dataTransfer.effectAllowed = "copy";
event.dataTransfer.setData(format, "card-34");
});
function acceptCopy(event) {
if (!event.dataTransfer.types.includes(format)) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
}
target.addEventListener("dragenter", acceptCopy);
target.addEventListener("dragover", acceptCopy);
target.addEventListener("drop", (event) => {
event.preventDefault();
const text = event.dataTransfer.getData(format);
if (!text) return;
target.textContent = text;
console.log(`${event.dataTransfer.dropEffect}: ${text}`);
});
document.body.append(source, target);
// Exercise the handlers once without mouse input. These synthetic events
// share an explicitly created store; they do not start a native drag.
const transfer = new DataTransfer();
function dispatchDrag(element, type) {
return element.dispatchEvent(new DragEvent(type, {
bubbles: true,
cancelable: true,
dataTransfer: transfer,
}));
}
if (!dispatchDrag(source, "dragstart")) return;
dispatchDrag(target, "dragenter");
const accepted = !dispatchDrag(target, "dragover");
if (accepted && transfer.effectAllowed === "copy" && transfer.dropEffect === "copy") {
dispatchDrag(target, "drop");
target.textContent = prompt; // Reset the box for a native drag.
}
})();Výsledok
copy: card-34
Spusť príklad v konzole prehliadača na prázdnej stránke. Simulované pustenie vypíše `copy: card-34` a vráti do poľa text „Drop here“. Potom do poľa presuň myšou „Drag card-34“. Pole zobrazí `card-34`, zdroj zostane na mieste a konzola znova vypíše `copy: card-34`.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3