CKTIS / JavaScript
DataTransfer: dopuštene radnje, učinak ispuštanja i podaci
Izvor određuje dopuštene radnje, odredište odabire jednu, a `setData()` sprema tekst koji odredište može pročitati pri ispuštanju.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
// 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 daje pristup objektu DataTransfer događaja povlačenja i ispuštanja. Taj web API definiran je standardom HTML i nije dio ECMAScripta 2024. Provjeri podršku u ciljnom okruženju.
Izvor: postavi effectAllowed sinkrono u dragstart. copy, move i link dopuštaju redom kopiranje, premještanje i stvaranje poveznice. copyLink, copyMove i linkMove dopuštaju jednu od dviju navedenih radnji, all dopušta sve tri, a none nijednu. Početna vrijednost uninitialized također dopušta sve tri, ali može utjecati na zadani odabir. Nevaljane vrijednosti i pokušaji upisa izvan načina za čitanje i pisanje zanemaruju se.
Odredište: ako u dragover prihvaćaš povlačenje, pozovi preventDefault() i postavi dropEffect na dopuštenu vrijednost copy, move ili link. none znači da nema radnje; ostale se vrijednosti zanemaruju. Preglednik određuje početnu vrijednost za dragenter i dragover prema dopuštenim radnjama i pravilima platforme, primjerice prema modifikacijskim tipkama. Neusklađen odabir ne omogućuje ispuštanje. U prihvaćenom drop pozovi preventDefault() i izvedi radnju u svom kodu: sama vrijednost move ne premješta element DOM-a.
Podaci: setData(format, data) prima dva znakovna niza i vraća undefined. Dodaje tekst za određeni format ili zamjenjuje postojeći tekst tog formata. ASCII slova u nazivu formata pretvaraju se u mala slova; text i url drugi su nazivi za text/plain i text/uri-list. Ako upis u spremište nije dopušten, metoda ništa ne mijenja.
Tekst upiši sinkrono u dragstart. Na odredištu ga pročitaj sinkrono pomoću getData() u drop, kada je spremište dostupno samo za čitanje. U dragover možeš provjeriti types, ali ne i pročitati sadržaj. Za kasniju upotrebu spremi pročitani niz, a ne objekt događaja. Ispuštene podatke smatraj nepouzdanima, a običan tekst prikaži pomoću textContent.
Primjeri
(() => {
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.
}
})();Rezultat
copy: card-34
Pokreni primjer u konzoli preglednika na praznoj stranici. Simulirano ispuštanje ispisuje `copy: card-34` i vraća tekst „Drop here” u okvir. Zatim mišem povuci „Drag card-34” u taj okvir. Okvir prikazuje `card-34`, izvor ostaje na mjestu, a konzola ponovno ispisuje `copy: card-34`.
Povezane lekcije
- JavaScript · Lekcija 34 · Srednje · Verzija: 3