HTMLElement: input event

The input event fires when the value of an <input>, <select>, or <textarea> element has been changed.

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 HTML Living Standard specification. However, historically this has not always been the case. Check compatibility, or use the change event instead for elements of these types.

For <textarea> and <input> elements that accept text input (type=text, type=tel, etc.), the interface is InputEvent; for others, the interface is Event.

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.

Syntax

Use the event name in methods like addEventListener(), or set an event handler property.

js

addEventListener("input", (event) => {});

oninput = (event) => {};

Event type

A generic Event.

Examples

This example logs the value whenever you change the value of the <input> element.

HTML

html

<input placeholder="Enter some text" name="name" />
<p id="values"></p>

JavaScript

js

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
UI Events
# event-type-input
HTML Standard
# handler-oninput

Browser compatibility

BCD tables only load in the browser

See also