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

CKTIS / HTML

onreset — gestionar el restablecimiento de formularios

El atributo onreset contiene JavaScript para gestionar el evento reset de un formulario. El controlador se ejecuta antes de que se restauren los valores predeterminados y puede cancelar el restablecimiento.

Versión: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxis

onreset="JavaScript code"

onreset es un atributo HTML de controlador de eventos para el evento reset. Su valor es código JavaScript, no el nombre de un evento ni un valor booleano. Suele colocarse en un formulario; el evento se propaga hacia arriba, por lo que también puede gestionarlo un elemento antecesor.

Al restablecer mediante un botón type="reset" o form.reset(), primero se envía al formulario un evento reset cancelable. Solo después se restauran los controles a su estado predeterminado, que no tiene por qué consistir en valores vacíos. Durante la gestión, el controlador aún puede leer los valores anteriores al restablecimiento.

Dentro del código del atributo, event hace referencia al evento y this al elemento que lo gestiona. event.preventDefault() o return false cancela el restablecimiento. return false por sí solo no detiene la propagación.

El atributo onreset y la propiedad JavaScript form.onreset configuran un mismo controlador único. Como alternativa, form.addEventListener('reset', handler) permite registrar varios controladores de forma independiente. Una política CSP puede bloquear el código del atributo; el ejemplo requiere que se permita su ejecución.

Ejemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onreset example</title>
<form id="demo" onreset="document.getElementById('log').textContent += 'during reset: ' + this.elements.namedItem('nickname').value + '\n';">
  <label>Nickname <input name="nickname" value="Ada"></label>
  <button type="reset">Reset</button>
</form>
<pre id="log"></pre>
<script>
  const form = document.getElementById('demo');
  const field = form.elements.namedItem('nickname');
  field.value = 'Grace';
  form.reset();
  document.getElementById('log').textContent += 'after reset: ' + field.value;
</script>
</html>

Resultado

during reset: Grace
after reset: Ada

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