CKTIS / JavaScript
Dogodki življenjskega cikla vlečenja v HTML
Spoznajte sedem dogodkov vlečenja v HTML, njihovo razdelitev med vir in cilj ter kdaj lahko DataTransfer berete ali spreminjate. Razumite, zakaj dragover zahteva preventDefault() in zakaj dragend ne dokazuje, da je bil spust uspešen.
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
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);Življenjski cikel vlečenja v HTML zajema sedem dogodkov v brskalniškem vmesniku HTML Drag and Drop in ni funkcija določene izdaje ECMAScripta. Vir prejme dragstart ob začetku vlečenja, ponavljajoče se dogodke drag med vlečenjem in dragend ob koncu. Morebitni cilji ob vstopu prejmejo dragenter, ponavljajoče se dogodke dragover, ob izhodu dragleave in drop, ko je element spuščen na veljavnem cilju. Število ponovitev in časovni razmiki niso določeni.
Običajen element omogočite za vlečenje z draggable = true. V dragstart zapišite besedilo z event.dataTransfer.setData(). Podatke lahko spreminjate samo v dragstart, njihovo vsebino pa berete v dragstart in drop; v dragover preverjajte razpoložljive vrste, ne vsebine. Če cilj po meri sprejema vlečene podatke, v brskalnikih zadošča klic preventDefault() v dragover. Standard HTML pa zahteva tudi preklic dogodka dragenter, da je običajen element izbran kot cilj spusta po meri. V drop prav tako prekličite privzeto vedenje in preberite podatke z getData().
dragend uporabite za čiščenje tudi, če je poteza preklicana, na primer s tipko Escape; sam dogodek ne dokazuje uspeha. effectAllowed določa dovoljene postopke vira, dropEffect pa označuje izbrani postopek; nobeden samodejno ne premakne elementov DOM. Z zunanjimi podatki ravnajte kot z nezaupanja vrednimi: preverite vrednosti in besedilo prikažite z textContent.
Primer kopira samo token-1 in ponuja gumb kot alternativo vlečenju. Preizkusite pravo potezo v ciljnem brskalniku: sintetični DragEvent ne posnema celotnega postopka, ki ga upravlja brskalnik. Vlečenje datoteke iz operacijskega sistema na strani ne sproži izvornih dogodkov dragstart ali dragend. Razpoložljivost Node 24 ne potrjuje podpore za te brskalniške vmesnike.
Primeri
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"));Rezultat
Dropped: token-1
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.