CKTIS / HTML
ondragover — obsługa przeciągania nad elementem
Atrybut ondragover zawiera kod JavaScript obsługujący zdarzenie dragover podczas przeciągania nad celem. Anulowanie zdarzenia przez event.preventDefault() pozwala zwykłemu elementowi uczestniczyć w przyjęciu upuszczenia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
ondragover="event.preventDefault()"ondragover jest atrybutem obsługi zdarzenia dragover. Jego wartość to kod JavaScript, a nie wartość logiczna. Procedura ma dostęp do event; zdarzenie jest wywoływane wielokrotnie podczas przeciągania nad celem, nie tylko w chwili wejścia na niego.
Dla zwykłego celu upuszczenia wywołaj event.preventDefault() podczas obsługi dragover. Anulowanie zdarzenia sygnalizuje akceptację operacji; samo ustawienie event.dataTransfer.dropEffect nie wystarcza. Wartość dropEffect, np. copy, musi być zgodna z effectAllowed źródła. Niektóre edytowalne elementy mają domyślną obsługę upuszczania tekstu.
ondragover nie odczytuje ani nie wstawia automatycznie przeciąganej zawartości. Dane odczytaj przez getData() w obsłudze drop; podczas dragover magazyn danych działa w trybie chronionym. W przykładzie dragstart zapisuje tekst, dragenter i dragover anulują zdarzenia, a drop aktualizuje wynik przez textContent.
Nie myl atrybutu z właściwością JavaScript element.ondragover, której przypisuje się funkcję, ani z addEventListener('dragover', handler), które rejestruje nasłuchiwanie bez prefiksu on.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragover example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'HELLO'); event.dataTransfer.effectAllowed = 'copy'">Drag HELLO</p>
<div style="padding: 2rem; border: 2px dashed"
ondragenter="event.preventDefault()"
ondragover="event.preventDefault(); event.dataTransfer.dropEffect = 'copy'"
ondrop="event.preventDefault(); document.getElementById('result').textContent = event.dataTransfer.getData('text/plain')">Drop here</div>
<p id="result" role="status">Waiting</p>
</html>Wynik
HELLO
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.