Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Događaji životnog ciklusa povlačenja u HTML-u

Upoznajte sedam HTML događaja povlačenja, njihovu podjelu između izvora i cilja te trenutke kada se DataTransfer može čitati ili mijenjati. Saznajte zašto dragover zahtijeva preventDefault() i zašto dragend ne potvrđuje uspješno ispuštanje.

Verzija: 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);

Događaji životnog ciklusa povlačenja u HTML-u obuhvaćaju sedam događaja pregledničkog sučelja HTML Drag and Drop i nisu značajka određenog izdanja ECMAScripta. Izvor prima dragstart na početku povlačenja, ponavljane događaje drag tijekom povlačenja i dragend na njegovu završetku. Mogući ciljevi primaju dragenter pri ulasku, ponavljane događaje dragover, dragleave pri izlasku i drop kada se stavka ispusti na valjan cilj. Broj ponavljanja i vremenski razmaci nisu fiksni.

Običan element učinite povlačivim pomoću draggable = true. U dragstart zapišite tekst s pomoću event.dataTransfer.setData(). Podatke je moguće mijenjati samo u dragstart, a njihov sadržaj čitati u dragstart i drop; u dragover provjerite dostupne vrste umjesto sadržaja. Ako prilagođeni cilj prihvaća povučene podatke, u preglednicima je dovoljno pozvati preventDefault() u dragover. Standard HTML-a, međutim, zahtijeva poništavanje i događaja dragenter da bi se običan element odabrao kao prilagođeni cilj ispuštanja. U drop također poništite zadano ponašanje i pročitajte podatke pomoću getData().

dragend upotrijebite za čišćenje čak i ako je gesta otkazana, primjerice tipkom Escape; njegovo pojavljivanje ne potvrđuje uspjeh. effectAllowed određuje dopuštene radnje izvora, dok dropEffect označava odabranu radnju; nijedno automatski ne premješta DOM elemente. S vanjskim podacima postupajte kao s nepouzdanima: provjerite vrijednosti i prikažite tekst pomoću textContent.

Primjer kopira samo token-1 i nudi gumb kao alternativu povlačenju. Testirajte stvarnu gestu u ciljnom pregledniku: sintetički DragEvent ne reproducira cijelu operaciju kojom upravlja preglednik. Povlačenje datoteke iz operacijskog sustava ne pokreće na stranici izvorne događaje dragstart ni dragend. Dostupnost Nodea 24 ne potvrđuje podršku za ta preglednička sučelja.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori