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

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.

Fontes