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.