ALLOWTRANSPARENCY Attribute | allowTransparency Property

Internet Development Index

Sets or retrieves whether the object can be transparent.


Scriptingobject.allowTransparency(v) [ = bClear ]

Possible Values

bClearBoolean that specifies or receives one of the following values.
falseDefault. Object is opaque. It cannot be transparent.
trueObject can be transparent.

The property is read/write. The property has a default value of false.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.


When the property is set to false, the backgroundColor property of the object can only be that of the window. When the property is set to true, the backgroundColor property of the object can be set to any value, including the default value of transparent.


The following example shows four ways to use the allowTransparency attribute, with and without the background-color attribute. Because the allowTransparency attribute of Frame1 is set to true, Frame1 renders red, the background color of the parent document. The allowTransparency attribute of Frame2 is also set to true, however the background-color attribute of Frame2 is set to green, so Frame2 renders green. Because the allowTransparency attribute of Frame3 is set to false (the default value), Frame3 renders white, the color of the t:SRC document. The allowTransparency attribute of Frame4 is also set to false, so Frame4 renders white even though the background-color attribute of Frame4 is set to green.

<BODY STYLE="background-color: red">
<IFRAME ID="Frame1" SRC="transparentBody.htm" allowTransparency="true">
<IFRAME ID="Frame2" SRC="transparentBody.htm" allowTransparency="true"
STYLE="background-color: green">
<IFRAME ID="Frame3" SRC="transparentBody.htm">
<IFRAME ID="Frame4" SRC="transparentBody.htm"
STYLE="background-color: green">
This feature requires Microsoft® Internet Explorer 5.5 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This property is a Microsoft extension to HTML Non-Microsoft link.

Applies To