Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła