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

CKTIS / JavaScript

Udalosti HTML dragstart, dragover, drop a dragend

Rozlišuj udalosti zdroja a cieľa, aby si mohol nastaviť údaje, povoliť pustenie, prečítať obsah a obnoviť dočasný stav aj po zrušení presúvania.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

source.draggable = true;
source.addEventListener("dragstart", onDragStart);
target.addEventListener("dragover", onDragOver);
target.addEventListener("drop", onDrop);
source.addEventListener("dragend", onDragEnd);

Tieto udalosti patria do rozhrania HTML na presúvanie v prehliadači, nie do ECMAScriptu. dragstart sa vyvolá na zdroji, napríklad na prvku s draggable="true". V jeho synchrónnej obsluhe môžeš údaje čítať aj zapisovať pomocou event.dataTransfer.setData(type, text). Zdroj určuje povolené operácie cez effectAllowed. Volanie preventDefault() pri dragstart zabráni začatiu presúvania.

dragover sa opakovane vyvoláva nad možným cieľom. Ak cieľ operáciu prijíma, zavolaj pri dragover metódu preventDefault() a prípadne nastav dropEffect na operáciu povolenú zdrojom. V chránenom režime možno cez dataTransfer.types skontrolovať formáty, ale nie čítať samotné údaje. Príklad ruší aj dragenter podľa modelu štandardu; v bežných prehliadačoch pre takúto zónu zvyčajne stačí zrušiť dragover.

drop sa vyvolá na cieli, keď používateľ pustí údaje na mieste, ktoré ich prijíma. Pri vlastnom spracovaní potlač predvolenú akciu volaním preventDefault() a načítaj údaje synchrónne cez getData(type). Pri chýbajúcom formáte dostaneš prázdny reťazec. S prijatým obsahom zaobchádzaj ako s nedôveryhodným: na zobrazenie obyčajného textu použi textContent, nie innerHTML.

dragend sa vyvolá na zdroji po skončení začatého presúvania, aj keď bolo zrušené alebo sa pustenie nepodarilo. Zruš tu dočasný stav; samotná udalosť nepotvrdzuje úspech. Hodnota "none" v dropEffect znamená, že sa nevykonala žiadna operácia pustenia. Pri presunutí súboru z operačného systému stránka nedostane udalosti zdroja. Podpora závisí od prehliadača a spôsobu ovládania; ponúkni aj spôsob vykonania akcie bez presúvania.

Príklady

(() => {
  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");
  }
})();

Výsledok

dragstart
drop: Card
dragend

Spusť kód v konzole prehliadača na prázdnej karte. Kód raz spustí obsluhu udalostí pomocou syntetických udalostí bez toho, aby si musel niečo presúvať. Cieľ zobrazí `Card`. Ak chceš vyskúšať natívne presúvanie, presuň „Drag this card“ na cieľ. Stlačenie Esc počas ďalšieho presúvania ho ukončí bez `drop`. Opakované udalosti `dragover` sa nevypisujú.

Súvisiace lekcie

  • JavaScript · Lekcia 34 · Stredne pokročilá · Verzia: 3

Zdroje