CKTIS / HTML
onclose — gestionar un evento close
El atributo onclose contiene código JavaScript que gestiona el evento close. Un uso habitual es responder cuando se cierra un elemento dialog, por ejemplo leyendo su returnValue. No sirve para impedir el cierre.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onclose="JavaScript statements"onclose es un atributo global de gestión de eventos para close. Su valor es código JavaScript, no un valor booleano. Puede escribirse en cualquier elemento HTML, pero añadir el atributo no hace que el elemento emita este evento por sí mismo.
Un uso habitual es con el elemento dialog. Al llamar a close() se cierra un cuadro de diálogo abierto y se pone en cola un evento close. Dentro del controlador del atributo, this hace referencia al elemento y event proporciona el objeto del evento. El resultado del cierre se lee mediante this.returnValue.
El evento close de un elemento dialog no se propaga y no se puede cancelar. Para impedir una solicitud de cierre, gestiona el evento cancelable cancel; close() omite esa etapa. Quitar manualmente el atributo open no dispara close.
No confundas el atributo con la propiedad JavaScript element.onclose, a la que se asigna una función, ni con addEventListener('close', handler), que permite registrar varios listeners. En el ejemplo, el controlador lee el resultado done y actualiza el texto solo después de que se distribuya el evento puesto en cola.
Ejemplos
<!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>Resultado
closed: done
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.