Note : Both Netscape and Internet Explorer support the Images collection (Netscape call it an array). For properties, methods and events that are supported by
<IMG> element, see the
The Images collection is an ordered, indexed (by document source order) array, containing a reference to every
<IMG> element in a document. For example, consider the following document:
Image Objects would normally be retrieved by their index in the Images collection (for example, above
document.images(3) contains a reference to the 4th image in the document element), but a string value can be used, as long as that string is a valid identifier (
NAME attribute value) for an image element in the document.
length property returns the number of elements in the collection. Note that the
length count starts at 1, not 0 as the images collection index does. Therefore, the
length property may return a value of 5, but to access the 3rd element, you'd need to use
item method retrieves single items, or sub-collections from the all collection. It accepts the following arguments:
index is a number, then the method returns a reference to the image object at that position in the images collection index. I.e.
bIsComplete be a boolean value dependant on the 3rd
index property is a string value, then the
item method returns a sub-collection, containing a reference to every image in the document that has its
NAME attribute set to the string contained in the
index argument. To retrieve certain element objects from this sub-collection, the
sub-index argument must be used.
© 1995-1998, Stephen Le Hunte