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

CKTIS / HTML

oninput — tratar o evento input

O atributo oninput contém código JavaScript que é executado quando ocorre o evento input. Num campo de texto, permite reagir às alterações do utilizador sem esperar que este saia do campo.

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

Sintaxe

oninput="JavaScript statements"

oninput é um atributo de conteúdo de tratamento do evento input, disponível em todos os elementos HTML. O seu valor é o corpo de uma função JavaScript, não apenas o nome de um evento ou uma declaração de função. A disponibilidade do atributo não significa que todos os elementos gerem estes eventos por si próprios.

Num campo de texto, input assinala alterações ao valor feitas pelo utilizador, por exemplo, ao escrever, colar ou apagar texto. Ao contrário de change, não espera que a edição seja confirmada, o que, num campo de texto, acontece normalmente quando o campo perde o foco. Atribuir um valor a value em JavaScript não desencadeia automaticamente input.

No código do atributo, this refere-se ao elemento que trata o evento, e event disponibiliza o objeto do evento. Existe também a propriedade JavaScript element.oninput: atribuir-lhe uma função substitui a função existente para esse handler; atribuir-lhe null desativa-o.

O exemplo copia o valor atual de this.value para textContent do elemento de resultado. A Content Security Policy (CSP) pode bloquear código inline; para executar este exemplo, é necessário permitir handlers de eventos inline.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>oninput example</title>
<label>Text: <input type="text" oninput="document.getElementById('result').textContent = this.value"></label>
<p>Value: <output id="result"></output></p>
</html>

Resultado

Value: abc

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