Embed object (Object/HTML)

An object that represents an embedded item in MSIE.

Availability:

JavaScript - 1.0
JScript - 3.0
Internet Explorer - 4.0
Netscape - 2.0
Netscape Enterprise Server - 2.0
Opera - 3.0
Inherits from:Element object
JavaScript syntax:IEmyEmbed = myDocument.all.anElementID
IEmyEmbed = myDocument.all.tags("EMBED")[anIndex]
IEmyEmbed = myDocument.all[aName]
-myEmbed = myDocument.anElementName
-myEmbed = myDocument.embeds[anIndex]
-myEmbed = myDocument.getElementById(anElementID)
-myEmbed = myDocument.getElementsByName(aName)[anIndex]
-myEmbed = myEmbedArray[aName]
-myEmbed = myEmbedArray[anIndex]
-myEmbed = myDocument.getElementsByTagName("EMBED")[anIndex]
HTML syntax:<EMBED>
Argument list:anIndexA reference to an element in a collection
aNameAn associative array reference
anElementIDThe ID value of an Element object
Object properties:accessKey, align, height, hidden, name, palette, pluginspage, readyState, src, tabIndex, units, width
Event handlers:onBlur, onClick, onDblClick, onFocus, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp

Netscape and MSIE encapsulate plugin/embedded objects in a different way. In MSIE they are objects of the EMBED class. In Netscape they are objects commonly referred to as belonging to the Plugin class, although they are really implemented as JavaObject objects. In MSIE, this is an ActiveX object.

There is additional confusion in that there is a plugins[] array that belongs to the document and another that belongs to the navigator object. They both contain collections of objects, but of different types. This is further confused by the fact that the document.plugins[] array is another name for the document.embeds[] array.

Because of this confusing situation, the best recommendation is that we refer to document.embeds[] and navigator.plugins[] and quietly ignore the document.plugins[] object. Furthermore we shall refer to Plugin objects as being something the browser can use to play embedded content and Embed objects will be an instance of a plugin that is alive and running in a document.

Warnings:

See also:<EMBED>, Document.embeds[], Element object, EmbedArray object, Input.accessKey, Plugin object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
accessKey1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.02.0 2.0 n/a n/a n/a n/aWarning
align n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
height n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
hidden n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
name1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a n/a-
palette n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly
pluginspage n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly
readyState n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly
src n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
tabIndex1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.02.0 2.0 n/a n/a n/a n/aWarning
units n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
width n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onBlur1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onClick1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDblClick1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onFocus1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning

Inheritance chain:

Element object, Node object