Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła