Synopsis

document.images[i]
document.images[image-name]
document.image-name

Constructor

new Image(width, height);

This constructor creates an off-screen Image object that cannot be displayed. The width and height arguments are optional. Setting the src attribute of the resulting object causes the browser to preload an image into its cache.

Properties

The Image object defines properties for each of the attributes of the HTML <img> element, such as src, border, width, height, vspace, and hspace. In addition, it defines or provides special behavior for the following properties:

complete

false if the image is still loading. true if it has finished loading or if there was an error while loading. Read-only.

src

A read/write string that specifies the URL of the image to be displayed by the browser. This property simply mirrors the src attribute of the <img> tag, but is detailed here because many important DHTML effects are created by dynamically setting the src property of an Image object, to replace one image with another.

Event Handlers

Image inherits event handlers from Element and also defines the following:

onabort

Invoked if the user aborts the download of an image.

onerror

Invoked if an error occurs while downloading the image.

onload

Invoked when the image successfully finishes loading.