CKTIS / JavaScript
Udalosti životného cyklu ťahania v HTML
Spoznajte sedem udalostí ťahania v HTML, ich rozdelenie medzi zdroj a cieľ a to, kedy možno DataTransfer čítať alebo meniť. Pochopte, prečo dragover vyžaduje preventDefault() a prečo dragend nedokazuje úspešné pustenie.
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
source.addEventListener("dragstart", handler);
source.addEventListener("drag", handler);
source.addEventListener("dragend", handler);
target.addEventListener("dragenter", handler);
target.addEventListener("dragover", handler);
target.addEventListener("dragleave", handler);
target.addEventListener("drop", handler);Medzi udalosti životného cyklu ťahania v HTML patrí sedem udalostí rozhrania HTML Drag and Drop v prehliadači; nejde o funkciu konkrétnej edície ECMAScriptu. Zdroj dostane dragstart pri začatí ťahania, opakované udalosti drag počas neho a dragend po jeho skončení. Potenciálne ciele dostanú pri vstupe dragenter, opakované udalosti dragover, pri opustení dragleave a drop, keď sa položka pustí na platný cieľ. Počet opakovaní ani časové odstupy nie sú pevne stanovené.
Bežný prvok nastavte ako ťahateľný pomocou draggable = true. V dragstart zapíšte text pomocou event.dataTransfer.setData(). Dáta možno meniť iba v dragstart a ich obsah čítať v dragstart a drop; v dragover kontrolujte dostupné typy namiesto obsahu. Ak vlastný cieľ prijíma ťahané dáta, v prehliadačoch stačí zavolať preventDefault() v dragover. Štandard HTML však vyžaduje zrušiť aj dragenter, aby sa bežný prvok vybral ako vlastný cieľ pustenia. V drop tiež zrušte predvolené správanie a prečítajte dáta pomocou getData().
Udalosť dragend použite na upratanie aj vtedy, keď sa gesto zruší, napríklad klávesom Escape; jej výskyt nedokazuje úspech. effectAllowed určuje povolené operácie zdroja, zatiaľ čo dropEffect označuje vybranú operáciu; ani jedna z týchto vlastností automaticky nepresúva prvky DOM. S externými dátami zaobchádzajte ako s nedôveryhodnými: kontrolujte hodnoty a text zobrazujte pomocou textContent.
Príklad kopíruje iba token-1 a ponúka tlačidlo ako alternatívu k ťahaniu. Otestujte skutočné gesto v cieľovom prehliadači: syntetická udalosť DragEvent nereprodukuje celý proces riadený prehliadačom. Potiahnutie súboru z operačného systému na stránke nevyvolá udalosti zdroja dragstart ani dragend. Dostupnosť Node 24 nepotvrdzuje podporu týchto rozhraní prehliadača.
Príklady
const panel = document.createElement("section");
const source = document.createElement("p");
const target = document.createElement("p");
const alternative = document.createElement("button");
const output = document.createElement("p");
source.textContent = "Drag token-1";
source.draggable = true;
target.textContent = "Drop here";
target.style.cssText = "padding: 2rem; border: 2px dashed;";
alternative.type = "button";
alternative.textContent = "Copy token-1 without dragging";
output.setAttribute("role", "status");
output.textContent = "Ready";
panel.append(source, target, alternative, output);
document.body.append(panel);
function accept(value) {
if (value === "token-1") {
output.textContent = `Dropped: ${value}`;
}
}
source.addEventListener("dragstart", (event) => {
event.dataTransfer.setData("text/plain", "token-1");
event.dataTransfer.effectAllowed = "copy";
source.style.opacity = "0.5";
});
target.addEventListener("dragover", (event) => {
if (event.dataTransfer.types.includes("text/plain")) {
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
}
});
target.addEventListener("drop", (event) => {
event.preventDefault();
accept(event.dataTransfer.getData("text/plain"));
});
source.addEventListener("dragend", () => {
source.style.opacity = "";
});
alternative.addEventListener("click", () => accept("token-1"));Výsledok
Dropped: token-1
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.