input

O evento input do DOM é disparado sincronicamente quando o valor de um elemento <input><select>, ou <textarea> é alterado. (Para elementos input com type=checkbox ou type=radio, o evento input não é disparado quando o usuário clica no elemento, porque o valor do atributo não é alterado.) Além disso, o evento é disparado no contenteditable editors quando o seu conteúdo é alterado. Nesse caso, O alvo do evento é o elemento host da edição. Se houver dois ou mais elementos que tenha contenteditable como true, o "host de edição" é o elemento antepassado mais próximo cujo pai não é editável. Similarmente, ele também é disparado no element raiz do designMode editors.

Informações gerais

Especificação
HTML5, DOM Level 3 Events
Interface
Event, InputEvent (en-US)
Borbulha
Sim
Cancelável
Não
Alvo
Elemento
Ação padrão
O valor ou o conteúdo é modificado.

Propriedades

Propriedade Tipo Descrição
target Somente leitura EventTarget O alvo do evento (o alvo mais alto na árvore DOM).
type Somente leitura DOMString Tipo do evento.
bubbles Somente leitura Boolean Se o evento borbulha ou não.
cancelable Somente leitura Boolean Se o evento é cancelável, ou não.

Compatibilidade com navegadores

Estamos convertendo nossos dados de compatibilidade para o formato JSON. Esta tabela de compatibilidade ainda usa o formato antigo, pois ainda não convertemos os dados que ela contém. Descubra como você pode ajudar! (en-US)

Funcionalidade Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Suporte básico (Yes) (Yes) (Yes)[1] 9[2] (Yes)[3] (Yes)
imediatamente ao compositionupdate (Yes) (Yes) 12 (12) (Yes) 15 (Yes)
ao contenteditable do elemento (Yes) (Yes) 14 (14) Não suportado[4]

 

15 (Yes)
quando designMode está "ativado" (Yes) ? 14 (14) Não suportado 15 (Yes)
data ? ? Não suportado ? ? ?
isComposing Não suportado ? 31 (31) Não suportado Não suportado Não suportado
<select> (Yes) Não suportado 49 (49) Não suportado ? ?
Funcionalidade Android Chrome for Android Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Suporte básico (Yes) (Yes) (Yes) (Yes) ? ? (Yes)
imediatamente ao compositionupdate ? ? (Yes) 12.0 (12) ? ? ?
ao contenteditable do elemento ? (Yes) ? 14.0 (14) ? ? (Yes)
quando designMode está "ativado" ? ? ? 14.0 (14) ? ? ?
data ? ? ? Não suportado ? ? ?
isComposing Não suportado Não suportado ? 31.0 (31) Não suportado Não suportado Não suportado
<select> ? (Yes) ? Não suportado ? ? ?

[1] Antes do Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9), Gecko não disparava eventos input embora a composição tenha continuado usando IMEs ou quando pressionado as "teclas mortas" do Mac OS X.

[2] IE 9 não dispara evento de input quando caracteres são deletados (ex.: pressionando Backspace ou Delete, ou utilizando a operação de cortar).

[3] Antes do Opera 15, Opera não disparava evento de input ao colar texto no input.

[4] O alvo do evento é o elemento mais interno na posição do cursor.

Veja também

O evento de change é relacionado. change dispara com menos frequência que o input – ele só irá disparar quando as mudanças forem finalizadas pelo usuário.