JavaScript: The Definitive Guide, Fourth Edition

Name

FileUpload.onchange — the handler invoked when input value changes

Available

JavaScript 1.0

Synopsis

<input type="file" onchange="handler"...> 
fileupload.onchange

Description

The onchange property of a FileUpload element specifies an event handler function that is invoked when the user changes the value in the input field (either by typing directly or using the Browse button) and then moves input focus elsewhere. This handler is intended to process a complete change to the input value and therefore is not invoked on a keystroke-by-keystroke basis.

The initial value of this property is a function that contains the semicolon-separated JavaScript statements specified by the onchange attribute of the HTML tag that defined the object. When an event handler function is defined by an HTML attribute, it is executed in the scope of element rather than in the scope of the containing window.

In the Netscape 4 event model, the onchange handler function is passed an Event object as an argument. In the IE event model, no argument is passed, but the applicable Event object is available as the event property of the Window object that contains the element.

See Also

Input.onchange; Chapter 19; Event, EventListener, and EventTarget in the DOM reference section