HTMLElement: input event
The input
event fires when the value
of an <input>
, <select>
, or <textarea>
element has been changed.
Bubbles | Yes |
---|---|
Cancelable | No |
Interface | InputEvent |
Event handler property | GlobalEventHandlers.oninput |
The event also applies to elements with contenteditable
enabled, and to any element when designMode
is turned on. In the case of contenteditable
and designMode
, the event target is the editing host. If these properties apply to multiple elements, the editing host is the nearest ancestor element whose parent isn't editable.
For <input>
elements with type=checkbox
or type=radio
, the input
event should fire whenever a user toggles the control, per the HTML5 specification. However, historically this has not always been the case. Check compatibility, or use the change
event instead for elements of these types.
Note: The input
event is fired every time the value
of the element changes. This is unlike the change
event, which only fires when the value is committed, such as by pressing the enter key, selecting a value from a list of options, and the like.
Examples
This example logs the value whenever you change the value of the <input>
element.
HTML
<input placeholder="Enter some text" name="name"/> <p id="values"></p>
JavaScript
const input = document.querySelector('input'); const log = document.getElementById('values'); input.addEventListener('input', updateValue); function updateValue(e) { log.textContent = e.target.value; }
Result
Specifications
Specification |
---|
HTML Standard (HTML) # event-input-input |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
input_event |
1 |
79
12-79
Not supported on
select , checkbox , or radio inputs. |
6 |
9
Only supports
input of type text and password . |
11.6 |
3.1 |
1 |
18 |
6 |
12 |
2 |
1.0 |
See also
- Related events
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event