Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

onclose — obravnava dogodka close

Atribut onclose vsebuje JavaScriptovo kodo za obravnavo dogodka close. Običajno se uporablja za odziv na zaprtje elementa dialog, na primer z branjem njegove vrednosti returnValue. Ne preprečuje zaprtja.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

onclose="JavaScript statements"

onclose je globalni atribut za obravnavo dogodka close. Njegova vrednost je JavaScriptova koda, ne logična vrednost. Zapišemo ga lahko na kateri koli element HTML, vendar samo dodajanje atributa ne povzroči, da element oddaja ta dogodek.

Običajno se uporablja pri elementu dialog. Klic close() zapre odprto pogovorno okno in postavi dogodek close v čakalno vrsto. V obravnavalniku atributa se this nanaša na element, event pa omogoča dostop do objekta dogodka. Rezultat zaprtja preberemo prek this.returnValue.

Dogodek close elementa dialog se ne razširja in ga ni mogoče preklicati. Če želimo preprečiti zahtevo za zaprtje, obravnavamo dogodek cancel, ki ga je mogoče preklicati; close() ta korak preskoči. Ročna odstranitev atributa open ne sproži dogodka close.

Atributa ne zamenjujte z lastnostjo JavaScript element.onclose, ki ji dodelimo funkcijo, ali z addEventListener('close', handler), ki omogoča registracijo več poslušalcev. V primeru obravnavalnik prebere rezultat done in posodobi besedilo šele, ko je dogodek iz čakalne vrste odposlan.

Primeri

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

Rezultat

closed: done

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri