This corresponds to the NAME attribute of the <IMG> tag.


DOM level - 1
JavaScript - 1.5
JScript - 3.0
Internet Explorer - 3.0
Netscape - 2.0
Property/method value type:String primitive

Objects are identified either by the NAME="..." HTML tag attribute or by the ID="..." HTML tag attribute.

Netscape shows a marginal preference for the name property while MSIE seems slightly better disposed towards the ID property. However, in many cases both browsers support either technique and in some cases will locate items named with either tag as if they existed in a single namespace.

This property cannot be used with IMG objects that are manufactured at run-time from the IMG() constructor. They can be collected in an array and accessed associatively as named array elements. Images you create in script aren't part of the document and therefore can't be addressed as if they are.