W3cubDocs

/Web APIs

GlobalEventHandlers.onchange

The onchange property of the GlobalEventHandlers mixin is an event handler for processing change events.

change events fire when the user commits a value change to a form control. This may be done, for example, by clicking outside of the control or by using the Tab key to switch to a different control.

Note: Unlike oninput, the onchange event handler is not necessarily called for each alteration to an element's value.

Syntax

target.onchange = functionRef;

functionRef is a function name or a function expression. The function receives an Event object as its sole argument.

Example

This example logs the number of characters in an <input> element, every time you modify its contents and then change focus away from it.

HTML

<input type="text" placeholder="Type something here, then click outside of the field." size="50">
<p id="log"></p>

JavaScript

let input = document.querySelector('input');
let log = document.getElementById('log');

input.onchange = handleChange;

function handleChange(e) {
  log.textContent = `The field's value is
      ${e.target.value.length} character(s) long.`;
}

Result

Specifications

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
onchange
1
12
1
9
9
3
1
18
4
10.1
1
1.0

See also

© 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/GlobalEventHandlers/onchange