Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła