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
| 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.