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

CKTIS / JavaScript

Dogodki HTML dragstart, dragover, drop in dragend

Loči dogodke izvora od dogodkov cilja, da nastaviš podatke, dovoliš spuščanje, prebereš vsebino in počistiš začasno stanje tudi po preklicu vlečenja.

Različica: 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 dogodki sodijo v brskalniški API HTML za vlečenje in spuščanje, ne v ECMAScript. dragstart se sproži na izvoru, na primer na elementu z draggable="true". V sinhronem obdelovalniku lahko bereš podatke in jih zapisuješ z event.dataTransfer.setData(type, text). Izvor določi dovoljene operacije z effectAllowed. Klic preventDefault() pri dragstart prepreči začetek vlečenja.

dragover se večkrat sproži nad možnim ciljem. Če cilj sprejema vlečenje, pri dragover pokliči preventDefault() in po potrebi nastavi dropEffect na operacijo, ki jo dovoljuje izvor. V zaščitenem načinu lahko prek dataTransfer.types preveriš formate, ne moreš pa prebrati podatkov. Primer po modelu standarda prekliče tudi dragenter; v razširjenih brskalnikih za takšno območje navadno zadošča preklic dragover.

drop se sproži na cilju, ko uporabnik spusti podatke na mestu, ki jih sprejema. Za lastno obdelavo s preventDefault() prepreči privzeto dejanje ter sinhrono preberi podatke z getData(type). Če formata ni, dobiš prazen niz. Prejeti vsebini ne zaupaj: navadno besedilo prikaži z textContent, ne z innerHTML.

dragend se sproži na izvoru, ko se začeto vlečenje konča, tudi če je bilo preklicano ali spuščanje ni uspelo. Tu počisti začasno stanje; sam dogodek še ne potrjuje uspeha. Vrednost "none" v dropEffect pomeni, da ni bila izvedena nobena operacija spuščanja. Ko datoteko povlečeš iz operacijskega sistema, stran ne prejme dogodkov izvora. Podpora je odvisna od brskalnika in načina vnosa; ponudi tudi možnost izvedbe dejanja brez vlečenja.

Primeri

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

Zaženi kodo v konzoli brskalnika na praznem zavihku. Koda s sintetičnimi dogodki enkrat sproži obdelovalnike, ne da bi moral kar koli povleči. Cilj prikaže `Card`. Če želiš preizkusiti vgrajeno vlečenje in spuščanje v brskalniku, povleci »Drag this card« na cilj. Pritisk tipke Esc med naslednjim vlečenjem ga konča brez `drop`. Ponavljajoči se dogodki `dragover` se ne izpisujejo.

Povezane lekcije

  • JavaScript · Lekcija 34 · Srednja · Različica: 3

Viri