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

CKTIS / HTML

onclose — spracovanie udalosti close

Atribút onclose obsahuje JavaScriptový kód, ktorý spracúva udalosť close. Bežne sa používa na reakciu na zatvorenie prvku dialog, napríklad prečítaním jeho returnValue. Neslúži na zabránenie zatvoreniu.

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

Syntax

onclose="JavaScript statements"

onclose je globálny atribút obsluhy udalosti close. Jeho hodnotou je JavaScriptový kód, nie logická hodnota. Možno ho zapísať na ľubovoľný prvok HTML, no samotné pridanie atribútu nespôsobí, že prvok začne túto udalosť vysielať.

Typickým použitím je prvok dialog. Volanie close() zatvorí otvorený dialóg a zaradí udalosť close do frontu. V obslužnej funkcii atribútu odkazuje this na prvok a event poskytuje objekt udalosti. Výsledok zatvorenia možno prečítať cez this.returnValue.

Udalosť close prvku dialog sa nešíri a nemožno ju zrušiť. Ak chcete zabrániť požiadavke na zatvorenie, spracujte zrušiteľnú udalosť cancel; samotné close() túto fázu obchádza. Ručné odstránenie atribútu open nevyvolá udalosť close.

Nezamieňajte si atribút s JavaScriptovou vlastnosťou element.onclose, ktorej sa priraďuje funkcia, ani s addEventListener('close', handler), ktorý umožňuje registrovať viacerých poslucháčov. V príklade obslužná funkcia prečíta výsledok done a aktualizuje text až po doručení udalosti zaradenej do frontu.

Príklady

<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
  <p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
  const dialog = document.getElementById('demo');
  dialog.show();
  dialog.close('done');
</script>

Výsledok

closed: done

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

Zdroje