Note : Both Netscape and Internet Explorer support the Embeds collection (Netscape call it an array). For properties, methods and events accessible through the Embeds array, see the <EMBED> topic.

The Embeds collection is an ordered, indexed array, containing a reference to every <EMBED> element in the document.

Embed Objects would normally be retrieved by their index in the Embeds collection (for example document.embeds(3) contains a reference to the 4th embedded object in the document), but a string value can be used, as long as that string is a valid identifier (ID attribute value) for an <EMBED> element.

Properties

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

Methods

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

embeds.item(index, sub-index)

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

strTag=document.embeds.item(2).pluginSpace

would make the value of strTag be the pluginSpace property (which reflects the PLUGINSPACE attribute) for the third <EMBED> element in the embeds collection.

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