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.