CKTIS / HTML
ondrop — obsługa upuszczenia danych
Atrybut ondrop definiuje kod JavaScript obsługujący zdarzenie drop podczas przeciągania i upuszczania. Sam nie tworzy obszaru przyjmującego dane: zwykle trzeba też anulować domyślną obsługę dragover.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
ondrop="JavaScript statements"
element.ondrop = function (event) { /* handler */ };ondrop jest globalnym atrybutem obsługi zdarzeń HTML: można go umieścić na dowolnym elemencie HTML. Jego wartość to kod JavaScript wykonywany po otrzymaniu zdarzenia drop, czyli upuszczeniu danych na zaakceptowany cel. Obiekt event udostępnia zdarzenie, a event.dataTransfer — przesyłane dane.
Samo ondrop nie wystarcza do utworzenia typowego celu upuszczania. W obsłudze dragover wywołaj event.preventDefault(), aby dopuścić upuszczenie. Przykład anuluje również dragenter. W obsłudze drop ponownie użyj event.preventDefault(), aby przejąć domyślne działanie, i odczytaj tekst przez event.dataTransfer.getData('text/plain').
Rozróżniaj atrybut HTML ondrop, którego wartością jest tekst kodu, od właściwości DOM element.ondrop, której przypisuje się funkcję lub null. Nazwa zdarzenia to drop, nie ondrop; przy użyciu addEventListener podaje się drop. Ponowne przypisanie element.ondrop zastępuje poprzednią funkcję tego mechanizmu.
Przykład przesyła stały tekst Hello i wyświetla go przez textContent, bez interpretowania danych jako HTML. Wymaga środowiska zezwalającego na skrypty i obsługę zdarzeń zapisaną bezpośrednio w atrybutach; ograniczenia bezpieczeństwa dokumentu mogą ją zablokować.
Przykłady
<!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>Wynik
Hello
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.