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

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

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

Източници