Note : Both Netscape and Internet Explorer support the Applets collection (Netscape call it an array). For properties, methods and events that are supported by <APPLET> elements, see the <APPLET> topic.

The Applets collection is an ordered, indexed array, containing a reference to every <APPLET> element in a document.

Applet Objects would normally be retrieved by their index in the Applets collection. I.e.:

document.applets(1).code

returns the CODE attribute of the second applet in the document.

A string value can be used however, as long as that string is a valid identifier (ID attribute value) for an <APPLET> element in the document.

E.g.

document.applets('MyCoolApplet').code

would return the CODE attribute of the applet whose NAME (or ID) property is 'MyCoolApplet'.

Properties

length
The length property returns the number of applet objects in the collection. Note that the length count starts at 1, not 0 as the applets collection index does. Therefore, the length property may return a value of 5, but to access the 3rd anchor, you'd need to use document.applets(2).property

Methods

item
The item method retrieves single items, or sub-collections from the applets collection. It accepts the following arguments:

applets.item(index, sub-index)

If index is a number, then the method returns a reference to the applet at that position in the applets collections index. I.e.

strTag=document.applets.item(2).code

would make strTag be the value of the CODE attribute of the documents third applet. As you can see, this is effectively the long-hand version of using document.applets(2).property.

If the index property is a string value, then the item method returns a sub-collection, containing a reference to every anchor in the document that has its NAME or ID 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