CKTIS / HTML
onchange — tratar um evento change
O atributo onchange contém JavaScript executado quando ocorre um evento change. Nos controlos de formulário, este evento representa uma alteração confirmada pelo utilizador, não necessariamente cada edição do valor.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
onchange="JavaScript statements"onchange é um atributo de conteúdo de manipulador de eventos para change. O seu valor é o corpo de uma função JavaScript, não o URL de um script. O atributo está disponível em todos os elementos HTML, mas adicioná-lo não faz, por si só, com que um elemento gere change.
O momento em que o evento ocorre depende do controlo. Uma caixa de verificação emite change quando o utilizador a ativa ou desativa; um campo de texto fá-lo normalmente quando o valor alterado é confirmado ao sair do campo. Utilize input para reagir às edições em curso. Atribuir .value ou .checked em JavaScript não emite change automaticamente.
No código do atributo, this refere-se ao elemento que trata o evento, e event disponibiliza o objeto do evento. O equivalente em JavaScript é a propriedade element.onchange; uma nova atribuição substitui a função anterior desse mecanismo. element.addEventListener('change', handler) permite registar ouvintes independentes. Uma política Content Security Policy pode bloquear o código dos atributos; nesse ambiente, utilize um script permitido com addEventListener().
Exemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onchange example</title>
<label>
<input type="checkbox" onchange="document.getElementById('state').textContent = this.checked ? 'ON' : 'OFF'">
Enabled
</label>
<p id="state" role="status">OFF</p>
</html>Resultado
OFF → ON → OFF
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.