CKTIS / HTML
onclose — een close-gebeurtenis afhandelen
Het onclose-attribuut bevat JavaScript-code die de close-gebeurtenis afhandelt. Een gebruikelijke toepassing is reageren wanneer een dialog-element wordt gesloten, bijvoorbeeld door de returnValue uit te lezen. Het voorkomt het sluiten niet.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onclose="JavaScript statements"onclose is een globaal eventhandlerattribuut voor close. De waarde is JavaScript-code, geen boolean. Het kan op elk HTML-element worden geschreven, maar het attribuut zorgt er op zichzelf niet voor dat een element deze gebeurtenis verzendt.
Een gebruikelijke toepassing is het element dialog. De aanroep close() sluit een geopend dialoogvenster en zet een close-gebeurtenis in de wachtrij. In de attribuuthandler verwijst this naar het element en geeft event het gebeurtenisobject. Het sluitresultaat lees je uit via this.returnValue.
De close-gebeurtenis van een dialog-element bubbelt niet en kan niet worden geannuleerd. Behandel de annuleerbare cancel-gebeurtenis om een sluitverzoek te voorkomen; close() slaat die stap zelf over. Het handmatig verwijderen van het attribuut open activeert geen close.
Verwar het attribuut niet met de JavaScript-eigenschap element.onclose, waaraan je een functie toewijst, of met addEventListener('close', handler), waarmee je meerdere listeners kunt registreren. In het voorbeeld leest de handler het resultaat done uit en werkt de tekst pas bij nadat de gebeurtenis uit de wachtrij is afgeleverd.
Voorbeelden
<!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>Resultaat
closed: done
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.