Nossos voluntários ainda não traduziram este artigo para o Português (do Brasil) . Junte-se a nós e ajude a fazer o trabalho!
The DOM input event is fired synchronously when the value of an <input> or <textarea> element is changed. (For input elements with type=checkbox or type=radio, the input event does not fire when a user clicks the control, because the value attribute does not change.) Additionally, it fires on contenteditable editors when its contents are changed. In this case, the event target is the editing host element. If there are two or more elements which have contenteditable as true, "editing host" is the nearest ancestor element whose parent isn't editable. Similarly, it's also fired on root element of designMode editors.
General info
- Specification
- HTML5, DOM Level 3 Events
- Interface
Event,InputEvent- Bubbles
- Yes
- Cancelable
- No
- Target
- Element
- Default Action
- The value or the content is modified.
Properties
| Property | Type | Description |
|---|---|---|
target Read only |
EventTarget |
The event target (the topmost target in the DOM tree). |
type Read only |
DOMString |
The type of event. |
bubbles Read only |
Boolean |
Whether the event normally bubbles or not |
cancelable Read only |
Boolean |
Whether the event is cancellable or not? |
Browser compatibility
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes)[1] | 9[2] | (Yes)[3] | (Yes) |
immediately after compositionupdate |
(Yes) | 12 (12) | (Yes) | 15 | (Yes) |
on contenteditable element |
(Yes) | 14 (14) | No support[4]
|
15 | (Yes) |
when designMode is "on" |
(Yes) | 14 (14) | No support | 15 | (Yes) |
data |
? | No support | ? | ? | ? |
isComposing |
No support | 31 (31) | No support | No support | No support |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | (Yes) | (Yes) | (Yes) | ? | ? | (Yes) |
immediately after compositionupdate |
? | ? | 12.0 (12) | ? | ? | ? |
on contenteditable element |
? | ? | 14.0 (14) | ? | ? | ? |
when designMode is "on" |
? | ? | 14.0 (14) | ? | ? | ? |
data |
? | ? | No support | ? | ? | ? |
isComposing |
No support | No support | 31.0 (31) | No support | No support | No support |
[1] Prior to Gecko 12.0 (Firefox 12.0 / Thunderbird 12.0 / SeaMonkey 2.9), Gecko didn't fire input events while composition was ongoing using IMEs or when dead keys were used on Mac OS X.
[2] IE 9 does not fire an input event when the user deletes characters from an input (e.g. by pressing Backspace or Delete, or using the "Cut" operation).
[3] Prior to Opera 15, Opera did not fire an input event after dropping text in an input field.
[4] The event target is the innermost element at the caret position.
See also
Also the change event is related. change fires less often than input – it only fires when the changes are committed by the user.