База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

HTML събитията dragstart, dragover, drop и dragend

Разграничавай събитията на източника и целта, за да задаваш данни, да разрешаваш пускането, да четеш съдържанието и да изчистваш временното състояние.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

Тези събития принадлежат към браузърния HTML API за влачене и пускане, а не към ECMAScript. dragstart се задейства при източника, например елемент с draggable="true". В синхронния обработчик можеш да четеш данните и да ги записваш чрез event.dataTransfer.setData(type, text). Източникът задава разрешените операции чрез effectAllowed. Извикването на preventDefault() при dragstart не позволява влаченето да започне.

dragover се задейства многократно над възможна цел. Ако целта приема влаченето, извикай preventDefault() при dragover и при нужда задай на dropEffect операция, разрешена от източника. В защитен режим можеш да провериш форматите чрез dataTransfer.types, но не и да прочетеш самите данни. Примерът отменя и dragenter според модела на стандарта; в широко използваните браузъри за такава зона обикновено е достатъчно да отмениш dragover.

drop се задейства при целта, когато потребителят пусне данните на място, което ги приема. При собствена обработка извикай preventDefault(), за да потиснеш действието по подразбиране, и прочети данните синхронно с getData(type). Ако форматът липсва, получаваш празен низ. Не се доверявай на полученото съдържание: показвай обикновен текст чрез textContent, а не чрез innerHTML.

dragend се задейства при източника в края на започнало влачене, дори то да е отменено или пускането да е неуспешно. Изчисти временното състояние тук; самото събитие не доказва успех. Стойност "none" на dropEffect означава, че не е извършена операция по пускане. При влачене на файл от операционната система страницата не получава събитията на източника. Поддръжката зависи от браузъра и начина на въвеждане; предложи и начин за извършване на действието без влачене.

Примери

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

Резултат

dragstart
drop: Card
dragend

Изпълни кода в конзолата на браузъра в празен раздел. Кодът извиква обработчиците веднъж чрез синтетични събития, без да е нужно да влачиш нищо, и целта показва `Card`. За да изпробваш вграденото в браузъра влачене и пускане, плъзни „Drag this card“ върху целта. Натискането на Esc по време на следващо влачене го прекратява без `drop`. Повтарящите се събития `dragover` не се извеждат в конзолата.

Свързани уроци

  • JavaScript · Урок 34 · Средно · Версия: 3

Източници