DHTML Collections

---

DOM Level 1 Specification.

Retrieves a collection of all IMG objects in a document.

[ collImages = ] document.images

[ oObject = ] document.images ( vIndex [ , iSubIndex ] )

collImages	Reference to an array of elements contained by the object.
oObject	Reference to an individual item in the array of elements contained by the object.
vIndex	Required. Number or string specifying the element or collection to retrieve. If this parameter is a number, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndex	Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id equal to the string and then retrieves from this collection the element at the position specified by iSubIndex.

The images collection returns an array, in source order, of all IMG elements in the current document.

The behavior is limited to IMG elements for backwards compatibility. Images created with the Image ( ) object constructor are not included in the collection.

This collection is indexed first by name, then by identifier. If duplicate names are found, a collection of those named items is returned. Collections of duplicate names must subsequently be referenced by ordinal position.

The following example shows how the images collection is used to return the src values of all the IMG elements embedded in this document. Press your browser back button to return to this page after.

<script language="JavaScript">
<!--
function getImgs ( ) {
   var img = "This page contains the following images:";
   for ( i = 0; i < document.images.length; i ++ )
      img += "\n" + document.images [ i ].src;
   alert ( img );
}
//—>
</script>

 Show me 

document