Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes