CKTIS / HTML
ondragleave — obsługa opuszczenia celu przeciągania
Atrybut ondragleave zawiera kod JavaScript obsługujący zdarzenie dragleave. Pozwala na przykład usunąć wyróżnienie poprzedniego celu podczas przeciągania; nie oznacza zakończenia całej operacji.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
ondragleave="JavaScript statements"ondragleave to atrybut obsługi zdarzeń dostępny na elementach HTML. Jego wartością jest treść funkcji w JavaScript, a nie nazwa zdarzenia ani wartość logiczna. Odpowiada zdarzeniu dragleave; w kodzie atrybutu event oznacza zdarzenie, a this — element obsługujący je.
Przeglądarka wysyła dragleave do poprzedniego elementu docelowego, gdy cel przeciągania się zmienia; zdarzenie może też wystąpić przy anulowaniu operacji. Nie należy mylić go z dragend, które dotyczy źródła i zakończenia przeciągania. dragleave propaguje się w górę drzewa i nie jest anulowalne: preventDefault() nie zatrzyma opuszczenia celu. Przy zagnieżdżonych elementach uwzględnij zdarzenia pochodzące od potomków.
Atrybut HTML przechowuje tekst kodu; właściwości element.ondragleave przypisuje się funkcję albo null. Alternatywą jest addEventListener('dragleave', handler). Polityka Content Security Policy może blokować kod w atrybutach.
Przykład celowo wysyła syntetyczne zdarzenie po kliknięciu Test, dzięki czemu wynik jest powtarzalny bez przeciągania myszą. Sprawdza uruchomienie procedury obsługi, a nie natywny mechanizm przeciągania i upuszczania.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>ondragleave test</title>
<div id="zone" ondragleave="this.textContent = 'dragleave received'">Waiting</div>
<button type="button" id="test">Test</button>
<script>
const zone = document.getElementById('zone');
document.getElementById('test').addEventListener('click', () => {
zone.dispatchEvent(new DragEvent('dragleave', {
bubbles: true,
cancelable: false
}));
});
</script>
</html>Wynik
dragleave received
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.