IFRAME object (Object/HTML)

An object that represents an <IFRAME> tag.

Availability:

DOM level - 1
JavaScript - 1.2
JScript - 3.0
Internet Explorer - 4.0
Netscape - 6.0
Inherits from:Element object
JavaScript syntax:IEmyIFRAME = myDocument.all.anElementID
IEmyIFRAME = myDocument.all.tags("IFRAME")[anIndex]
IEmyIFRAME = myDocument.all[aName]
-myIFRAME = myDocument.aName
-myIFRAME = myDocument.getElementById(anElementID)
-myIFRAME = myDocument.getElementsByName(aName)[anIndex]
-myIFRAME = myDocument.getElementsByTagName("IFRAME")[anIndex]
HTML syntax:<IFRAME> ... </IFRAME>
Argument list:anIndexA reference to an element in a collection
aNameAn associative array reference
anElementIDThe ID value of an Element object
Object properties:align, dataFld, dataSrc, frameBorder, frameSpacing, height, hspace, longDesc, marginHeight, marginWidth, name, noResize, scrolling, src, tabIndex, vspace, width
Event handlers:onClick, onDblClick, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp

An <IFRAME> is a special MSIE supported tag that introduces an inline frame into a document that appears like a block structured element within the document text flow, accessible as a named frame object that belongs to the document.

Its properties appear to be all read-only in the MSIE browser. Changing them seems to have no visible effect at all. The properties belonging to the object retain the values that you assign and return them when requested but the display does not change.

The DOM level 1 specification refers to IFRAME objects as IFrameElement objects and this makes them available in Netscape by virtue of its support for DOM level 1.

DOM level 2 adds the contentDocument properties.

Warnings:

See also:Element object, Frame object, Window object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
align1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
dataFld1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
dataSrc1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
frameBorder1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
frameSpacing n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
height1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
hspace n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
longDesc1.5 1.5 n/a6.0 6.0 n/a n/a n/a n/a1 1 n/a n/aWarning
marginHeight1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
marginWidth1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning
name1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
noResize n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
scrolling1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
src1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
tabIndex1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/a-
vspace n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
width1.5 1.53.0 3.06.0 6.04.0 4.0 n/a n/a n/a1 1 n/a n/aWarning

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onClick1.51.51.0 1.02.0 2.03.0 3.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onDblClick1.51.53.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.5 1.53.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.5 1.53.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.5 1.53.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.5 1.53.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.5 1.53.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.51.53.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.5 1.51.0 1.02.0 2.03.0 3.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.51.53.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