Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

ondragend — obsługa zakończenia przeciągania

Atrybut ondragend uruchamia kod JavaScript po zakończeniu przeciągania, także po anulowaniu lub nieudanym upuszczeniu. Służy do sprzątania stanu elementu źródłowego, a nie do potwierdzania przyjęcia danych przez cel.

Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately

Składnia

ondragend="JavaScript statements"

ondragend to atrybut obsługi zdarzenia dragend, dozwolony na każdym elemencie HTML. Jego wartością jest kod JavaScript, nie wartość logiczna. W kodzie atrybutu parametr event udostępnia obiekt zdarzenia. Sam atrybut nie włącza przeciągania; w przykładzie służy do tego draggable="true".

Zdarzenie dragend jest wysyłane do źródła po zakończeniu operacji przeciągania, również po anulowaniu lub odrzuconym upuszczeniu. W przeciwieństwie do drop nie jest zdarzeniem przyjęcia danych przez cel. Nadaje się do usuwania wizualnych oznaczeń przeciągania. Wynik operacji można sprawdzić przez event.dataTransfer.dropEffect; wartość none oznacza brak wykonanej operacji.

W JavaScript można też przypisać funkcję do właściwości element.ondragend albo zarejestrować nasłuch przez element.addEventListener('dragend', handler). Nazwa zdarzenia to dragend, bez prefiksu on. Polityka Content Security Policy może blokować kod zapisany bezpośrednio w atrybucie; w takim środowisku użyj dozwolonego skryptu z addEventListener.

Przykład ustawia tekst statusu na Drag ended, niezależnie od powodzenia upuszczenia. Nie implementuje celu upuszczenia ani przenoszenia danych.

Przykłady

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragend example</title>
<p draggable="true"
   ondragstart="event.dataTransfer.setData('text/plain', 'Sample')"
   ondragend="document.getElementById('status').textContent = 'Drag ended'">
  Drag this text
</p>
<p id="status" role="status">Ready</p>
</html>

Wynik

Drag ended

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła