Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

onreset — tratar a reposição de formulários

O atributo onreset contém código JavaScript que trata o evento reset de um formulário. O processador é executado antes de os valores predefinidos serem repostos e pode cancelar a reposição.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onreset="JavaScript code"

onreset é um atributo HTML para processar o evento reset. O seu valor é código JavaScript, não o nome de um evento nem um valor booleano. É normalmente colocado num formulário; o evento propaga-se para os elementos ancestrais, pelo que também pode ser tratado por um deles.

Uma reposição acionada por um botão type="reset" ou por form.reset() começa por enviar ao formulário um evento reset cancelável. Só depois os controlos regressam ao seu estado predefinido — que não corresponde necessariamente a valores vazios. Durante o processamento, o processador ainda pode ler os valores anteriores à reposição.

No código do atributo, event refere-se ao evento e this ao elemento que o processa. event.preventDefault() ou return false cancela a reposição. return false, por si só, não interrompe a propagação.

O atributo onreset e a propriedade JavaScript form.onreset configuram o mesmo processador único. Em alternativa, form.addEventListener('reset', handler) permite registar vários processadores de forma independente. Uma política CSP pode bloquear o código do atributo; o exemplo requer que a sua execução seja permitida.

Exemplos

<!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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes