CKTIS / HTML
ondrop — обработване на пуснати данни
Атрибутът ondrop задава JavaScript код, който обработва събитието drop при плъзгане и пускане. Сам по себе си той не създава цел за пускане: обикновено трябва да се отмени и стандартната обработка на dragover.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop е глобален HTML атрибут за обработчик на събития и може да присъства върху всеки HTML елемент. Стойността му е JavaScript код, който се изпълнява при получаване на събитие drop, тоест когато данни бъдат пуснати върху приета цел. Обектът event предоставя достъп до събитието, а event.dataTransfer — до прехвърлените данни.
Самостоятелен обработчик ondrop не създава обичайна цел за пускане. Извикай event.preventDefault() в обработчика dragover, за да разрешиш пускането. Примерът отменя и dragenter. В обработчика drop използвай отново event.preventDefault(), за да поемеш стандартното действие, и прочети текста с event.dataTransfer.getData('text/plain').
Разграничавай HTML атрибута ondrop, чиято стойност е текст на код, от DOM свойството element.ondrop, на което се присвоява функция или null. Името на събитието е drop, а не ondrop; при addEventListener се използва drop. Повторното присвояване на element.ondrop заменя предишната функция, регистрирана чрез този механизъм.
Примерът прехвърля фиксирания текст Hello и го показва чрез textContent, без да интерпретира данните като HTML. Необходима е среда, която допуска скриптове и обработчици на събития, зададени директно в атрибутите; ограниченията за сигурност на документа могат да ги блокират.
Примери
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrop example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'Hello'); event.dataTransfer.effectAllowed = 'copy'">Drag Hello</p>
<div ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')"
style="padding: 2rem; border: 2px dashed">Drop here</div>
<p id="result">Waiting</p>
</html>Резултат
Hello
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.