Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri