CKTIS / HTML
ondrag — obsługa zdarzenia przeciągania
Atrybut ondrag zawiera kod JavaScript obsługujący zdarzenie drag, wysyłane wielokrotnie do źródła podczas przeciągania. Sam atrybut nie sprawia, że element można przeciągać, i nie definiuje celu upuszczenia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<element ondrag="JavaScript statements"></element>ondrag to atrybut obsługi zdarzeń dostępny na wszystkich elementach HTML. Jego wartością jest kod JavaScript wykonywany po otrzymaniu zdarzenia drag. W kodzie atrybutu parametr event udostępnia obiekt zdarzenia. Odpowiada mu również właściwość JavaScript element.ondrag.
Podczas natywnego przeciągania przeglądarka okresowo wysyła drag do węzła źródłowego. Nie jest to zdarzenie każdego ruchu wskaźnika; nie zakładaj stałej częstotliwości. Dla zwykłego elementu ustaw draggable="true", aby umożliwić przeciąganie — samo ondrag tego nie robi.
Rozróżniaj ondragstart (rozpoczęcie), ondrag (trwanie), ondragover (przeciąganie nad potencjalnym celem), ondrop (upuszczenie) i ondragend (zakończenie). ondrag nie zastępuje obsługi celu upuszczenia. Dane przeciągania ustawiaj w dragstart; podczas drag magazyn danych działa w trybie chronionym, więc treść danych jest niedostępna.
Przykład zmienia tekst statusu na drag received po otrzymaniu drag. Kolejne zdarzenia zachowują ten sam tekst, dzięki czemu oczekiwany wynik nie zależy od ich liczby. Zapisz plik HTML, otwórz go w przeglądarce i przeciągnij Drag me.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondrag example</title>
<p draggable="true"
ondragstart="event.dataTransfer.setData('text/plain', 'demo')"
ondrag="document.getElementById('status').textContent = 'drag received'">Drag me</p>
<output id="status">ready</output>
</html>Wynik
ready → drag received
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.