Availability

JavaScript 1.1

Synopsis

<img ... onload="handler" ... >
image.onload

Description

The onload property of an Image object specifies an event handler function that is invoked when an image loads successfully.

The initial value of this property is a function that contains the JavaScript statements specified by the onload attribute of the <img> tag that defined the Image 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 onload 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

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