CKTIS / HTML
oncancel — gestionar el evento cancel
El atributo oncancel contiene el código que se ejecuta al recibirse un evento cancel. En un elemento dialog, permite responder a una solicitud de cierre y, si el evento se puede cancelar, impedir que se cierre.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
oncancel="JavaScript statements"
element.oncancel = function (event) { /* ... */ };oncancel es un atributo de controlador del evento cancel, disponible en todos los elementos HTML. Su valor es código JavaScript, no un nombre de evento ni un valor booleano. Su equivalente en JavaScript es la propiedad element.oncancel, a la que se puede asignar una función o null.
Un uso habitual es el elemento dialog: cancel señala una solicitud de cierre, no un cierre ya completado. El método requestClose() activa primero cancel; el método close() omite ese paso. En cambio, el evento close indica que se ha cerrado.
Cuando event.cancelable es true, event.preventDefault() impide el cierre predeterminado. Devolver false desde un controlador oncancel también cancela el evento si se puede cancelar. No des por hecho que se pueden bloquear todas las solicitudes de cierre.
El ejemplo abre un cuadro de diálogo no modal y llama a requestClose(). El atributo impide que se cierre, por lo que el resultado registrado es open: true. El close() final quita el cuadro de diálogo de la vista sin volver a activar cancel.
Ejemplos
<!doctype html>
<meta charset="utf-8">
<title>oncancel</title>
<dialog id="demo" oncancel="event.preventDefault()">
<p>Dialog</p>
</dialog>
<pre id="result"></pre>
<script>
const demo = document.getElementById('demo');
const result = document.getElementById('result');
demo.show();
demo.requestClose();
result.textContent = `open: ${demo.open}`;
demo.close();
</script>Resultado
open: true
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.