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.