CKTIS / HTML
onclose — obrada događaja close
Atribut onclose sadrži JavaScript kod koji obrađuje događaj close. Uobičajena je primjena reakcija na zatvaranje elementa dialog, primjerice čitanjem njegova returnValue. Ne služi za sprečavanje zatvaranja.
Verzija: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaksa
onclose="JavaScript statements"onclose je globalni atribut rukovatelja događajem close. Njegova je vrijednost JavaScript kod, a ne logička vrijednost. Može se zapisati na bilo koji HTML element, ali samo dodavanje atributa ne uzrokuje da element emitira taj događaj.
Uobičajena je primjena element dialog. Poziv close() zatvara otvoreni dijaloški okvir i stavlja događaj close u red čekanja. U rukovatelju atributa this upućuje na element, a event daje objekt događaja. Rezultat zatvaranja čita se putem this.returnValue.
Događaj close elementa dialog ne propagira se i ne može se otkazati. Da biste spriječili zahtjev za zatvaranjem, obradite događaj cancel, koji se može otkazati; sam close() zaobilazi taj korak. Ručno uklanjanje atributa open ne pokreće close.
Nemojte miješati atribut sa svojstvom JavaScripta element.onclose, kojemu se dodjeljuje funkcija, ni s addEventListener('close', handler), koji omogućuje registraciju više slušatelja. U primjeru rukovatelj čita rezultat done i ažurira tekst tek nakon što se događaj iz reda čekanja isporuči.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.