---

<iframe> (Floating Frame)

This element indicates a floating frame, an independently controllable content region that can be embedded in a page.

Standard Syntax (Transitional and Frameset Only)

Attributes Defined by Internet Explorer 4

allowtransparency="false | true" (5.5)
application="yes" (5)
border="pixels" (4)
bordercolor="color name | #RRGGBB" (4)
datafld="name of column supplying bound data" (4)
datasrc="id of data source object supplying data" (4)
frameborder="no | yes | 0 | 1" (4)
hidefocus="true | false" (5.5)
hspace="pixels" (4)
language="javascript | jscript | vbs | vbscript" (4)
security="restricted" (6)
tabindex="number" (5.5)
unselectable="on | off" (5.5)
vspace="pixels" (4)

Standard Event Attributes

onclick, ondblclick, onkeydown, onkeypress, onkeyup, onmousedown, onmousemove, onmouseout, onmouseover, onmouseup

Events Defined by Internet Explorer

onactivate, onafterupdate, onbeforedeactivate, onbeforeupdate, onblur, oncontrolselect, ondeactivate, onerrorupdate, onfocus, onload, onmove, onmoveend, onmovestart, onreadystatechange, onresizeend, onresizestart, ontimeerror

Element Specific Attributes

align

This attribute controls the horizontal alignment of the floating frame with respect to the page. The default is left.

allowtransparency

This Internet Explorer–specific attribute determines whether the <iframe> is transparent or opaque. The default value is false, which means it is opaque.

application

This Microsoft-specific attribute is used to indicate whether the contents of an <iframe> are to be considered an HTA application. HTA applications are applications that use HTML, JavaScript, and Internet Explorer, but are not limited to the typical type of security considerations of a Web page. Given its security implications, this attribute should only be set if the developer is familiar with HTAs.

border

This attribute specifies the thickness of the border in pixels.

bordercolor

This attribute specifies the color of the border.

datafld

This attribute specifies the column name from the data source object that supplies the bound data.

datasrc

This attribute indicates id of the data source object that supplies the data that is bound to this element.

frameborder

This attribute determines whether the frame is surrounded by a border. The HTML 4 specification defines 0 to be off and 1 to be on. The default value is 1. Internet Explorer also defines the values no and yes.

framespacing

This attribute creates additional space between the frames.

height

The attribute sets the floating frame's height in pixels.

hspace

This attribute specifies margins for the frame.

longdesc

This attribute specifies a URL of a document which contains a long description of the frame's contents. This might be particularly useful as a complement to the <title> element.

marginheight

This attribute sets the height in pixels between the floating frame's content and its top and bottom borders.

marginwidth

This attribute sets the width in pixels between the floating frame's content and its left and right borders.

name

This attribute assigns the floating frame a name so that it can be the target destination of hyperlinks.

scrolling

This attribute determines if the frame has scroll bars. A yes value forces scroll bars; a no value prohibits them.

security

This attribute sets the value indicating whether the source file of an iframe has security restrictions applied. The only allowed value is restricted.

src

This attribute contains the URL of the content to be displayed in the floating frame. If absent, the frame is blank.

vspace

This attribute specifies margins for the frame.

width

This attribute sets the floating frame's width in pixels.

Example

<iframe src="http://www.democompany.com" height="150"
   width="200" name="FloatingFrame1">
Sorry, your browser doesn't support inline frames.
</iframe>

Compatibility

HTML 4 (transitional)
XHTML 1.0 (transitional or frameset)
Internet Explorer 3, 4, 5, 5.5, 6
Netscape 6, 7
Opera 5-7

Notes

Under the HTML 4 strict specification, the iframe element is not defined. However, under XHTML transitional and XHTML frameset, iframe is allowed. XHTML 1.1 does not allow it either. Floating frames can be somewhat imitated using the div element and CSS positioning facilities.

When a browser does not understand an <iframe> tag, it displays the text included within it as an alternate rendering.