CKTIS / JavaScript
HTML događaji dragstart, dragover, drop i dragend
Razlikuj događaje izvora i odredišta kako bi postavio podatke, prihvatio ispuštanje, pročitao sadržaj i očistio privremeno stanje čak i nakon otkazivanja.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);Ti događaji pripadaju preglednikovu HTML API-ju za povlačenje i ispuštanje, a ne ECMAScriptu. dragstart se aktivira na izvoru, primjerice na elementu s draggable="true". U sinkronoj obradi događaja možeš čitati podatke i zapisivati ih s event.dataTransfer.setData(type, text). Izvor određuje dopuštene operacije svojstvom effectAllowed. Poziv preventDefault() na dragstart sprječava početak povlačenja.
dragover se opetovano aktivira iznad mogućeg odredišta. Ako odredište prihvaća povlačenje, pozovi preventDefault() na dragover i po potrebi postavi dropEffect na operaciju koju izvor dopušta. U zaštićenom načinu možeš provjeriti formate preko dataTransfer.types, ali ne možeš čitati podatke. Primjer otkazuje i dragenter u skladu s modelom standarda; u uobičajenim preglednicima za takvu je zonu uglavnom dovoljno otkazati dragover.
drop se aktivira na odredištu kad korisnik ispusti podatke na mjestu koje ih prihvaća. Za vlastitu obradu pozovi preventDefault() kako bi spriječio zadanu radnju i pročitaj podatke sinkrono s getData(type). Ako format nedostaje, dobivaš prazan niz znakova. Primljeni sadržaj smatraj nepouzdanim: običan tekst prikaži pomoću textContent, a ne innerHTML.
dragend se aktivira na izvoru kad započeto povlačenje završi, čak i ako je otkazano ili ispuštanje nije uspjelo. Ovdje očisti privremeno stanje; sam događaj ne potvrđuje uspjeh. Vrijednost "none" u dropEffect znači da nije izvršena nijedna operacija ispuštanja. Kad povučeš datoteku iz operacijskog sustava, stranica ne prima događaje izvora. Podrška ovisi o pregledniku i načinu unosa; ponudi i način izvođenja radnje bez povlačenja.
Primjeri
(() => {
const panel = document.createElement("section");
panel.style.cssText = "position:fixed;top:16px;left:16px;z-index:1000;padding:16px;background:white;color:black;display:flex;gap:16px";
const source = document.createElement("div");
const target = document.createElement("div");
source.draggable = true;
source.textContent = "Drag this card";
source.style.cssText = "padding:16px;border:1px solid;cursor:grab";
target.textContent = "Drop here";
target.style.cssText = "padding:16px;border:2px dashed;min-width:100px";
panel.append(source, target);
document.body.append(panel);
let active = false;
const accepts = (event) => active && event.dataTransfer?.types.includes("text/plain");
source.addEventListener("dragstart", (event) => {
const transfer = event.dataTransfer;
transfer.setData("text/plain", "Card");
transfer.effectAllowed = "copy";
active = true;
source.style.opacity = "0.5";
console.log("dragstart");
});
target.addEventListener("dragenter", (event) => {
if (accepts(event)) event.preventDefault();
});
target.addEventListener("dragover", (event) => {
if (!accepts(event)) return;
event.preventDefault();
event.dataTransfer.dropEffect = "copy";
});
target.addEventListener("drop", (event) => {
if (!accepts(event)) return;
event.preventDefault();
const text = event.dataTransfer.getData("text/plain");
target.textContent = text;
console.log(`drop: ${text}`);
});
source.addEventListener("dragend", () => {
active = false;
source.style.opacity = "";
console.log("dragend");
});
// Exercise the same handlers once without a pointer gesture.
const transfer = new DataTransfer();
const dispatch = (element, type) => element.dispatchEvent(new DragEvent(type, {
bubbles: true,
cancelable: type !== "dragend",
dataTransfer: transfer,
}));
if (dispatch(source, "dragstart")) {
dispatch(target, "dragenter");
// dispatchEvent returns false when the handler cancels dragover.
if (!dispatch(target, "dragover")) dispatch(target, "drop");
dispatch(source, "dragend");
}
})();Rezultat
dragstart drop: Card dragend
Pokreni kôd u konzoli preglednika na praznoj kartici. Kôd jednom pokreće obradu događaja pomoću sintetičkih događaja, bez potrebe za povlačenjem. Odredište prikazuje `Card`. Za provjeru ugrađenog povlačenja i ispuštanja u pregledniku povuci „Drag this card” na odredište. Pritiskom na Esc tijekom novog povlačenja ono završava bez `drop`. Ponovljeni događaji `dragover` ne ispisuju se.
Povezane lekcije
- JavaScript · Lekcija 34 · Srednje · Verzija: 3