Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje