O evento input do DOM é disparado sincronicamente quando o valor de um elemento {{HTMLElement("input")}}, {{HTMLElement("select")}}, ou {{HTMLElement("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.
| Propriedade | Tipo | Descrição |
|---|---|---|
target {{readonlyInline}} |
{{domxref("EventTarget")}} | O alvo do evento (o alvo mais alto na árvore DOM). |
type {{readonlyInline}} |
{{domxref("DOMString")}} | Tipo do evento. |
bubbles {{readonlyInline}} |
{{jsxref("Boolean")}} | Se o evento borbulha ou não. |
cancelable {{readonlyInline}} |
{{jsxref("Boolean")}} | Se o evento é cancelável, ou não. |
{{CompatibilityTable}}
| Funcionalidade | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Suporte básico | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}}[1] | 9[2] | {{CompatVersionUnknown}}[3] | {{CompatVersionUnknown}} |
imediatamente ao compositionupdate |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("12")}} | {{CompatVersionUnknown}} | 15 | {{CompatVersionUnknown}} |
ao contenteditable do elemento |
{{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoDesktop("14")}} | {{CompatNo}}[4]
|
15 | {{CompatVersionUnknown}} |
quando designMode está "ativado" |
{{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatGeckoDesktop("14")}} | {{CompatNo}} | 15 | {{CompatVersionUnknown}} |
data |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
isComposing |
{{CompatNo}} | {{CompatUnknown}} | {{CompatGeckoDesktop("31")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
| <select> | {{CompatVersionUnknown}} | {{CompatNo}} | {{CompatGeckoDesktop("49")}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} |
| Funcionalidade | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Suporte básico | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatVersionUnknown}} |
imediatamente ao compositionupdate |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("12")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
ao contenteditable do elemento |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatGeckoMobile("14")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatVersionUnknown}} |
quando designMode está "ativado" |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatGeckoMobile("14")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
data |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
isComposing |
{{CompatNo}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatGeckoMobile("31")}} | {{CompatNo}} | {{CompatNo}} | {{CompatNo}} |
| <select> | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatUnknown}} | {{CompatNo}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
[1] Antes do Gecko 12.0 {{geckoRelease("12.0")}}, 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.
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.