Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

oncancel — obsluha udalosti cancel

Atribút oncancel obsahuje kód, ktorý sa spustí pri prijatí udalosti cancel. Na prvku dialog umožňuje reagovať na požiadavku na zatvorenie a zabrániť zatvoreniu, ak možno udalosť zrušiť.

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

Syntax

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

oncancel je atribút obsluhy udalosti cancel, ktorý je dostupný na všetkých prvkoch HTML. Jeho hodnotou je kód JavaScriptu, nie názov udalosti ani logická hodnota. Zodpovedajúcou vlastnosťou v JavaScripte je element.oncancel, ktorej možno priradiť funkciu alebo null.

Typickým použitím je prvok dialog: cancel signalizuje požiadavku na zatvorenie, nie už dokončené zatvorenie. Metóda requestClose() najprv vyvolá cancel; metóda close() tento krok preskočí. Udalosť close naopak informuje o zatvorení.

Ak má event.cancelable hodnotu true, event.preventDefault() zabráni predvolenému zatvoreniu. Vrátenie hodnoty false z obsluhy oncancel tiež zruší udalosť, ak ju možno zrušiť. Nepredpokladajte, že možno zablokovať každú požiadavku na zatvorenie.

Príklad otvorí nemodálny dialóg a zavolá requestClose(). Atribút zabráni zatvoreniu, takže zaznamenaný výsledok je open: true. Záverečné close() odstráni dialóg zo zobrazenia bez toho, aby znova vyvolalo cancel.

Prí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ýsledok

open: true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje