Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

oncancel — obsluha události cancel

Atribut oncancel obsahuje kód, který se spustí při přijetí události cancel. U prvku dialog umožňuje reagovat na požadavek na zavření a zabránit zavření, pokud lze událost zrušit.

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

Syntaxe

oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };

oncancel je atribut obsluhy události cancel, který je dostupný u všech prvků HTML. Jeho hodnotou je kód JavaScriptu, nikoli název události nebo logická hodnota. Odpovídající vlastností v JavaScriptu je element.oncancel, které lze přiřadit funkci nebo null.

Typickým použitím je prvek dialog: cancel signalizuje požadavek na zavření, nikoli již dokončené zavření. Metoda requestClose() nejprve vyvolá cancel; metoda close() tento krok přeskočí. Událost close naproti tomu oznamuje zavření.

Pokud má event.cancelable hodnotu true, event.preventDefault() zabrání výchozímu zavření. Vrácení hodnoty false z obsluhy oncancel také zruší událost, pokud ji lze zrušit. Nepředpokládejte, že lze zablokovat každý požadavek na zavření.

Příklad otevře nemodální dialog a zavolá requestClose(). Atribut zabrání zavření, takže zaznamenaný výsledek je open: true. Závěrečné close() odstraní dialog ze zobrazení, aniž by znovu vyvolalo cancel.

Příklady

<!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>

Výsledek

open: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje