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 | nullDragEvent.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.