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

CKTIS / JavaScript

DragEvent.dataTransfer — данни при плъзгане

DragEvent.dataTransfer предоставя обекта DataTransfer на събитие при плъзгане. Достъпът до данните зависи от етапа на операцията; събитие, създадено чрез скрипт, може да върне null.

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

Синтаксис

event.dataTransfer // DataTransfer | null

DragEvent.dataTransfer е свойство само за четене, което връща DataTransfer или null. Браузърът свързва обект с нативните събития при плъзгане. При new DragEvent("drop") стойността на dataTransfer по подразбиране е null; на конструктора може изрично да се подаде обект. Само препратката е само за четене, а не цялото съдържание на обекта.

При нативно плъзгане данните могат да се записват чрез setData() по време на dragstart. По време на drop могат да се прочетат чрез getData(), но не и да се променят. При останалите събития от тази операция хранилището на данни е в защитен режим: форматите могат да се проверят чрез types, но getData() връща празен низ. files предоставя файловете, а items — елементите с данни.

Ако скрипт създаде събитие dragover и му подаде нов обект DataTransfer, хранилището не преминава в защитен режим. getData() все още може да върне данните, записани чрез setData().

За да приема обикновен елемент пускане, отмени dragover чрез preventDefault(). При нативно плъзгане прочети данните синхронно в обработчика на drop, преди достъпът до хранилището да приключи. Копирай необходимите стойности, преди да извършваш асинхронна работа.

Това е API на браузъра, дефиниран от HTML, а не функция на конкретно издание на ECMAScript. Наличието му в Node 24 не доказва поддръжка в браузърите. Примерът изисква конструкторите DragEvent и DataTransfer; създаването на събитие чрез скрипт не започва нативно плъзгане.

Примери

(() => {
  const transfer = new DataTransfer();
  transfer.setData("text/plain", "CKTIS");

  const event = new DragEvent("drop", { dataTransfer: transfer });
  const emptyEvent = new DragEvent("drop");

  console.log(event.dataTransfer === transfer);
  console.log(event.dataTransfer.getData("text/plain"));
  console.log(emptyEvent.dataTransfer === null);
})();

Резултат

true
CKTIS
true

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

Източници