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

CKTIS / JavaScript

Събития от жизнения цикъл на влаченето в HTML

Научете седемте HTML събития при влачене, разпределението им между източника и целта и кога DataTransfer може да се чете или променя. Разберете защо dragover изисква preventDefault() и защо dragend не доказва успешно пускане.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

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);

Събитията от жизнения цикъл на влаченето в HTML са седем събития от браузърния HTML Drag and Drop API, а не функция на конкретно издание на ECMAScript. Източникът получава dragstart при започване на влаченето, повтарящи се събития drag по време на влаченето и dragend при приключването му. Потенциалните цели получават dragenter при влизане, повтарящи се събития dragover, dragleave при излизане и drop, когато елемент бъде пуснат върху валидна цел. Броят на повторенията и интервалите между тях не са фиксирани.

Направете обикновен елемент влачаем с draggable = true. В dragstart запишете текст чрез event.dataTransfer.setData(). Данните могат да се променят само в dragstart, а съдържанието им може да се чете в dragstart и drop; в dragover проверявайте наличните типове, а не съдържанието. На практика в браузърите е достатъчно да извикате preventDefault() в dragover, когато персонализираната цел приема влачените данни. Стандартът HTML обаче изисква да отмените и dragenter, за да бъде избран обикновен елемент като персонализирана цел за пускане. В drop също отменете поведението по подразбиране и прочетете данните с getData().

Използвайте dragend за почистване дори когато жестът е отменен, например с Escape; настъпването му не доказва успех. effectAllowed задава разрешените операции на източника, а dropEffect показва избраната операция; нито едно от тях не премества автоматично DOM елементи. Третирайте външните данни като ненадеждни: проверявайте стойностите и показвайте текста чрез textContent.

Примерът копира само token-1 и предлага бутон като алтернатива на влаченето. Тествайте реален жест в целевия браузър: синтетичен DragEvent не възпроизвежда цялата операция, управлявана от браузъра. Влаченето на файл от операционната система не задейства на страницата събитията на източника dragstart или dragend. Наличието на Node 24 не потвърждава поддръжка на тези браузърни интерфейси.

Примери

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"));

Резултат

Dropped: token-1

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници