CKTIS / HTML
oncancel — obsługa zdarzenia cancel
Atrybut oncancel zawiera kod wykonywany po otrzymaniu zdarzenia cancel. W przypadku elementu dialog pozwala zareagować na żądanie zamknięcia i, jeśli zdarzenie można anulować, zapobiec zamknięciu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel jest atrybutem obsługi zdarzenia cancel, dostępnym na wszystkich elementach HTML. Jego wartość to kod JavaScript, a nie nazwa zdarzenia ani wartość logiczna. W JavaScript odpowiada mu właściwość element.oncancel, której można przypisać funkcję lub null.
Typowym zastosowaniem jest element dialog: cancel sygnalizuje żądanie zamknięcia, a nie zakończone zamknięcie. Metoda requestClose() najpierw wywołuje cancel; metoda close() pomija ten etap. Zdarzenie close informuje natomiast o zamknięciu.
Jeśli event.cancelable ma wartość true, event.preventDefault() zapobiega domyślnemu zamknięciu. Zwrócenie false z funkcji oncancel również anuluje zdarzenie, o ile można je anulować. Nie zakładaj, że każde żądanie zamknięcia można zablokować.
Przykład otwiera niemodalne okno dialogowe i wywołuje requestClose(). Atrybut blokuje zamknięcie, więc zapisany wynik to open: true. Końcowe close() usuwa okno z ekranu bez ponownego wywołania cancel.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>oncancel</title>
<dialog id="demo" oncancel="event.preventDefault()">
<p>Dialog</p>
</dialog>
<pre id="result"></pre>
<script>
const demo = document.getElementById('demo');
const result = document.getElementById('result');
demo.show();
demo.requestClose();
result.textContent = `open: ${demo.open}`;
demo.close();
</script>Wynik
open: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.