ifram

I 元素 | i 对象 IMG 元素 | img 对象 DHTML 对象

IFRAME 元素 | iframe 对象

--------------------------------------------------------------------------------

创建内嵌浮动框架。

成员表

下面的表格列出了 iframe 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。

标签属性/属性

标签属性 属性 描述
ALIGN align 设置或获取表格排列。
ALLOWTRANSPARENCY allowTransparency 设置或获取对象是否可为透明。
APPLICATION APPLICATION 表明对象的内容是否为 HTML 应用程序(HTA)，以便免除浏览器安全模式。
ATOMICSELECTION  指定元素及其内容是否可以一不可见单位统一选择。
BEGIN begin 设置或获取时间线在该元素上播放前的延迟时间。
BORDER border 设置或获取框架间的空间，包括 3D 边框。
canHaveChildren 获取表明对象是否可以包含子对象的值。
canHaveHTML 获取表明对象是否可以包含丰富的 HTML 标签的值。
CLASS className 设置或获取对象的类。
contentWindow 获取指定的 frame 或 iframe 的 window 对象。
DATAFLD dataFld 设置或获取由 dataSrc 属性指定的绑定到指定对象的给定数据源的字段。
DATASRC dataSrc 设置或获取用于数据绑定的数据源。
disabled 获取表明用户是否可与该对象交互的值。
END end 设置或获取表明元素结束时间的值，或者元素设置为重复的简单持续终止时间。
firstChild 获取对象的 childNodes 集合的第一个子对象的引用。
FRAMEBORDER frameBorder 设置或获取是否显示框架的边框。
hasMedia 获取一个表明元素是否为 HTML+TIME 媒体元素的 Boolean 值。
HEIGHT height 设置或获取对象的高度。
HIDEFOCUS hideFocus 设置或获取表明对象是否显式标明焦点的值。
HSPACE hspace 设置或获取对象的水平边距。
ID id 获取标识对象的字符串。
innerText 设置或获取位于对象起始和结束标签内的文本。
isContentEditable 获取表明用户是否可编辑对象内容的值。
isDisabled 获取表明用户是否可与该对象交互的值。
isMultiLine 获取表明对象的内容是包含一行还是多行的值。
isTextEdit 获取是否可使用该对象创建一个 TextRange 对象。
LANG lang 设置或获取要使用的语言。
LANGUAGE language 设置或获取当前脚本编写用的语言。
lastChild 获取该对象 childNodes 集合中最后一个子对象的引用。
longDesc 设置或获取对象长描述的统一资源标识符(URI)。
MARGINHEIGHT marginHeight 设置或获取显示框架中文本之前的上下边距高度。
MARGINWIDTH marginWidth 设置或获取显示框架中文本之前的左右边距宽度。
NAME name 设置或获取框架的名称。
nextSibling 获取对此对象的下一个兄弟对象的引用。
nodeName 获取特定结点类型的名称。
nodeType 获取所需结点的类型。
nodeValue 设置或获取结点的值。
offsetHeight 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的高度。
offsetLeft 获取对象相对于版面或由 offsetParent 属性指定的父坐标的计算左侧位置。
offsetParent 获取定义对象 offsetTop 和 offsetLeft 属性的容器对象的引用。
offsetTop 获取对象相对于版面或由 offsetTop 属性指定的父坐标的计算顶端位置。
offsetWidth 获取对象相对于版面或由父坐标 offsetParent 属性指定的父坐标的宽度。
onOffBehavior 获取表明指定的 Microsoft® DirectAnimation® 行为是否正在运行的对象。
outerHTML 设置或获取对象及其内容的 HTML 形式。
outerText 设置或获取对象的文本。
ownerDocument 设置或获取结点关联的 document 对象。
parentElement 获取对象层次中的父对象。
parentNode 获取文档层次中的父对象。
parentTextEdit 获取文档层次中可用于创建包含原始对象的 TextRange 的容器对象。
previousSibling 获取对此对象的上一个兄弟对象的引用。
readyState 获取对象的当前状态。
readyState 获取表明对象当前状态的值。
recordNumber 获取数据集中生成对象的原始记录。
scopeName 获取为该元素定义的命名空间。
SCROLLING scrolling 设置或获取框架是否可被滚动。
SECURITY SECURITY 获取表明 frame 或 iframe 的源文件是否应用了特定的安全限制的值。
sourceIndex 获取对象在源序中的依次位置，即对象出现在 document 的 all 集合中的顺序。
SRC src 设置或获取要由对象装入的 URL。
STYLE  为该设置元素设置内嵌样式。
SYNCMASTER syncMaster 设置或获取时间容器是否必须在此元素上同步回放。
SYSTEMBITRATE  获取系统中大约可用带宽的 bps。
SYSTEMCAPTION  表明是否要显示文本来代替演示的的音频部分。
SYSTEMLANGUAGE  表明是否在用户计算机上的选项设置中选中了给定语言。
SYSTEMOVERDUBORSUBTITLE  指定针对那些正在观看演示但对被播放的音频所使用的语言并不熟悉的用户来说是否要渲染配音或字幕。
TABINDEX tabIndex 设置或获取定义对象的 Tab 顺序的索引。
tagName 获取对象的标签名称。
tagUrn 设置或获取在命名空间声明中指定的统一资源名称(URN)。
TIMECONTAINER timeContainer 设置或获取与元素关联的时间线类型。
TITLE title 设置或获取对象的咨询信息(工具提示)。
uniqueID 获取为对象自动生成的唯一标识符。
UNSELECTABLE  指定该元素不可被选中。
VSPACE vspace 设置或获取对象的垂直边距。
WIDTH width 设置或获取对象的宽度。

行为

行为 描述
clientCaps 提供关于 Internet Explorer 支持的特性的信息，以及提供即用即装的方法。
download 下载文件并在下载完成后通知一个指定的回调函数。
homePage 包含关于用户主页的信息。
time 为 HTML 元素提供一个活动的时间线。
time2 为 HTML 元素或一组元素提供一个活动的时间线。

集合

集合 描述
all 返回对象所包含的元素集合的引用。
attributes 获取对象标签属性的集合。
behaviorUrns 返回标识附加到该元素行为的统一资源名称(URN)字符串的集合。
childNodes 获取作为指定对象直接后代的 HTML 元素和 TextNode 对象的集合。
children 获取作为对象直接后代的 DHTML 对象的集合。

事件

事件 描述
onactivate 当对象设置为活动元素时触发。
onafterupdate 当成功更新数据源对象中的关联对象后在数据绑定对象上触发。
onbeforedeactivate 在 activeElement 从当前对象变为父文档其它对象之前立即触发。
onbeforeupdate 当成功更新数据源对象中的关联对象前在数据绑定对象上触发。
onblur 在对象失去输入焦点时触发。
oncontrolselect 当用户将要对该对象制作一个控件选中区时触发。
ondeactivate 当 activeElement 从当前对象变为父文档其它对象时触发。
onerrorupdate 更新数据源对象中的关联数据出错时在数据绑定对象上触发。
onfocus 当对象获得焦点时触发。
onload 在浏览器完成对象的装载后立即触发。
onmove 当对象移动时触发。
onmoveend 当对象停止移动时触发。
onmovestart 当对象开始移动时触发。
onreadystatechange 当对象状态变更时触发。
onresizeend 当用户更改完控件选中区中对象的尺寸时触发。
onresizestart 当用户开始更改控件选中区中对象的尺寸时触发。
ontimeerror 当特定时间错误发生时无条件触发，通常由将属性设置为无效值导致。

滤镜

滤镜属性 描述
Alpha 调整对象内容的不透明度。
AlphaImageLoader 在对象的边界和对象背景到内容之间显示图像，可选剪裁或缩放图像大小。当装入便携网络图像(PNG)时，从 0 到 100% 的 透明度都是支持的。
Barn 以开门或关门的运动方式显示对象的新内容。
BasicImage 调整对象内容的颜色处理、图像旋转或不透明度。
BlendTrans 以渐隐原始内容的形式显示对象的新内容。
Blinds 以打开或关闭盲点的运动方式显示对象的新内容。
Blur 模糊对象的内容以便使其看起来失去焦点。
CheckerBoard 以揭开覆盖在原始内容上的棋盘的形式显示对象的新内容。
Chroma 将对象内容的指定颜色显示为透明。
Compositor 以新旧内容逻辑颜色组合的形式显示对象的新内容。每个版本的颜色和 alpha 值都会被计算用来决定输出图像的最终颜色。
DropShadow 创建对象内容的实体阴影，偏移量位于指定方向。这将使得内容看起来是浮动的因此会产生阴影。
Emboss 使用灰度值对对象以浮雕纹理显示。
Engrave 使用灰度值对对象以雕刻纹理显示。
Fade 以渐隐原始内容的形式显示对象的新内容。
FlipH 以沿水平方向翻转的形式显示对象内容。
FlipV 以沿垂直方向翻转的形式显示对象内容。
Glow 在对象边缘外侧添加光晕以便使其看起来像发光的样子。
Gradient 在对象的背景和内容之间显示一个渐变色彩的表面。
GradientWipe 以在原有内容上覆盖渐变带的形式显示对象的新内容。
Gray 以灰度显示对象内容。
ICMFilter 根据图像颜色管理(ICM)配置文件转换对象的彩色内容。这将允许指定内容的显示效果得以改善，或者在打印机或监视器等硬件设备上模拟显示。
Inset 以对角线方向显示对象的新内容。
Invert 反转对象内容的色调、饱和度和亮度。
Iris 以彩虹效果显示对象的新内容，这与照相机光圈打开相似。
Light 在对象的内容上创建灯光效果。
MaskFilter 将对象内容的透明像素显示为彩色遮罩，将非透明像素显示为透明。
Matrix 使用矩阵变换缩放、旋转或显现对象的内容。
MotionBlur 以运动模糊的效果显示对象内容。
Pixelate 将对象的内容显示为彩色方块，其颜色取决于该方块所替代区域的平均颜色值。此滤镜显示可用于切换。
RadialWipe 以辐射状擦除的形式显现对象的新内容。
RandomBars 以随机像素线爆炸的形式显现对象的新内容。
RandomDissolve 以随机像素爆炸的形式显现对象的新内容。
Redirect 目前还不支持。
RevealTrans 使用 24 种预先定义的切换效果显现对象的新内容。
Shadow 创建对象内容的实体阴影，偏移量位于指定方向。这将创建阴影效果。
Slide 以图像滑行的形式显现对象的新内容。
Spiral 以螺旋运动的形式显现对象的新内容。
Stretch 以拉伸覆盖原始内容的形式显现对象的新内容。有一个选项类似立方体从一个表面转到另外一个表面。
Strips 以条形覆盖的形式显现对象的原始内容，好像有一把锯将原始内容锯开。
Wave 在对象的内容上执行垂直方向的正弦波扭曲。
Wheel 以旋转运动的形式显现对象的新内容，好像轮子滚过原始内容。
Xray 更改对象内容的颜色深度将其以黑白显示。
Zigzag 在对象上将对象的新内容进行来回移动以便覆盖原始内容。

方法

方法 描述
addBehavior 给元素附加一个行为。
appendChild 给对象追加一个子元素。
applyElement 使得元素成为其它元素的子元素或父元素。
attachEvent 将指定函数绑定到事件，以便每当该事件在对象上触发时都调用该函数。
blur 使元素失去焦点并触发 onblur 事件。
clearAttributes 从对象中删除全部标签属性和值。
cloneNode 从文档层次中复制对对象的引用。
componentFromPoint 通过特定事件返回对象在指定坐标下的位置。
contains 检查对象中是否包含给定元素。
detachEvent 从事件中取消指定函数的绑定，这样当事件触发时函数就不会收到通知了。
dragDrop 初始化拖曳事件。
fireEvent 触发对象的指定事件。
focus 使得元素得到焦点并执行由 onfocus 事件指定的代码。
getAdjacentText 返回邻接文本字符串。
getAttribute 获取指定标签属性的值。
getAttributeNode 获取由 attribute.name 属性引用的 attribute 对象。
getElementsByTagName 获取基于指定元素名称的对象集合。
getExpression 获取给定属性的表达式。
hasChildNodes 返回表明对象是否有子对象的值。
insertAdjacentElement 在指定位置插入元素。
insertAdjacentHTML 在指定位置的元素中插入给定的 HTML 文本。
insertAdjacentText 在指定位置插入给定的文本。
insertBefore 在文档层次中插入元素作为父对象的子结点。
mergeAttributes 复制所有读/写标签属性到指定元素。
normalize 合并邻接 TextNode 对象以便生成一个常规的文档对象模型。
removeAttribute 删除对象的给定标签属性。
removeAttributeNode 从对象中删除删除 attribute 对象。
removeBehavior 分离元素的行为。
removeChild 从元素上删除子结点。
removeExpression 从指定属性中删除表达式。
removeNode 从文档层次中删除对象。
replaceAdjacentText 替换元素的邻接文本。
replaceChild 用新的子元素替换已有的子元素。
replaceNode 用其它元素替换对象。
scrollIntoView 将对象滚动到可见范围内，将其排列到窗口顶部或底部。
setActive 设置对象为当前对象而不将对象置为焦点。
setAttribute 设置指定标签属性的值。
setAttributeNode 设置 attribute 对象为对象的一部分。
setExpression 设置指定对象的表达式。
swapNode 交换文档层次中两个对象的位置。

对象

对象 描述
runtimeStyle 代表了居于全局样式表、内嵌样式和 HTML 标签属性指定的格式和样式之上的对象的格式和样式。
style 代表了给定元素所有可能的内嵌样式的当前设置。

样式

样式标签属性 样式属性 描述
ACCELERATOR accelerator 设置或获取表明对象是否包含快捷键的字符串。
background-attachment backgroundAttachment 设置或获取背景图像如何附加到文档内的对象中。
background-color backgroundColor 设置或获取对象内容后的颜色。
background-position-x backgroundPositionX 设置或获取 backgroundPosition 属性的 x 坐标。
background-position-y backgroundPositionY 设置或获取 backgroundPosition 属性的 y 坐标。
behavior behavior 设置或获取 DHTML 行为的位置。
border-bottom borderBottom 设置或获取对象下边框的属性。
border-bottom-color borderBottomColor 设置或获取对象下边框的颜色。
border-bottom-style borderBottomStyle 设置或获取对象下边框的样式。
border-bottom-width borderBottomWidth 设置或获取对象下边框的宽度。
border-color borderColor 设置或获取对象的边框颜色。
border-left borderLeft 设置或获取对象左边框的属性。
border-left-color borderLeftColor 设置或获取对象左边框的颜色。
border-left-style borderLeftStyle 设置或获取对象左边框的样式。
border-left-width borderLeftWidth 设置或获取对象左边框的宽度。
border-right borderRight 设置或获取对象右边框的属性。
border-right-color borderRightColor 设置或获取对象右边框的颜色。
border-right-style borderRightStyle 设置或获取对象右边框的样式。
border-right-width borderRightWidth 设置或获取对象右边框的宽度。
border-style borderStyle 设置或获取对象上下左右边框的样式。
border-top borderTop 设置或获取对象上边框的属性。
border-top-color borderTopColor 设置或获取对象上边框的颜色。
border-top-style borderTopStyle 设置或获取对象上边框的样式。
border-top-width borderTopWidth 设置或获取对象上边框的宽度。
border-width borderWidth 设置或获取对象上下左右边框的宽度。
bottom bottom 设置或获取对象相对于文档层次中下个定位对象的底部的位置。
clear clear 设置或获取对象是否允许在其左侧、右侧或两边放置浮动对象，以防下段文本显示在浮动对象上。
clip clip 设置或获取定位对象的哪个部分可见。
cursor cursor 设置或获取当鼠标指针指向对象时所使用的鼠标指针。
display display 设置或获取对象是否要渲染。
filter filter 设置或获取应用于对象的滤镜或滤镜集合。
height height 设置或获取对象的高度。
layout-grid layoutGrid 设置或获取指定文本字符版面的组合文档格线属性。
layout-grid-mode layoutGridMode 设置或获取文本布局网格是否使用二维。
left left 设置或获取对象相对于文档层次中下个定位对象的左边界的位置。
margin margin 设置或获取对象的上下左右边距。
margin-bottom marginBottom 设置或获取对象的下边距宽度。
margin-left marginLeft 设置或获取对象的左边距宽度。
margin-right marginRight 设置或获取对象的右边距宽度。
margin-top marginTop 设置或获取对象的上边距宽度。
overflow-x overflowX 设置或获取当内容超出对象宽度时如何管理对象内容。
overflow-y overflowY 设置或获取当内容超出对象高度时如何管理对象内容。
pixelBottom 设置或获取对象的下方位置。
pixelHeight 设置或获取对象的高度。
pixelLeft 设置或获取对象的左侧位置。
pixelRight 设置或获取对象的右侧位置。
pixelTop 设置或获取对象的上方位置。
pixelWidth 设置或获取对象的宽度。
posBottom 设置或获取以 bottom 标签属性指定的单位的对象下方位置。
posHeight 设置或获取以 height 标签属性指定的单位的对象高度。
position position 设置或获取对象所使用的定位方式。
posLeft 设置或获取以 left 标签属性指定的单位的对象左侧位置。
posRight 设置或获取以 right 标签属性指定的单位的对象右侧位置。
posTop 设置或获取以 top 标签属性指定的单位的对象上方位置。
posWidth 设置或获取以 width 标签属性指定的单位的对象宽度。
right right 设置或获取对象相对于文档层次中下个已定位的对象的右边界的位置。
float styleFloat 设置或获取文本要绕排到对象的哪一侧。
text-autospace textAutospace 设置或获取自动留空和文本的窄空间宽度调整。
top top 设置或获取对象相对于文档层次中下个定位对象的上边界的位置。
visibility visibility 设置或获取对象的内容是否显示。
z-index zIndex 设置或获取定位对象的堆叠次序。
zoom zoom 设置或获取对象的放大比例。

注释

IFRAME 元素也就是文档中的文档，或者好像浮动的框架(FRAME)。frames 集合提供了对 IFRAME 内容的访问。请使用 frames 集合读写 IFRAME 内包含的元素。例如，如果要访问 iframe 内 body 对象的 backgroundColor 样式，语法应为:

sColor = document.frames("sFrameName").document.body.style.backgroundColor;

通过 iframe 对象所在页面的对象模型，你可以访问 iframe 对象的属性，但不能访问其内容。例如，访问 iframe 对象的 border 样式的语法应为:

sBorderValue = document.all.oFrame.style.border;

注意  iframe 的属性必须使用前缀 document.all 访问，例如 document.all.iframeId.marginWidth。
Internet Explorer 5.5 支持浮动框架的内容透明。如果想要为浮动框架定义透明内容，则必须满足下列条件。

与 IFRAME 元素一起使用的 ALLOWTRANSPARENCY 标签属性必须设置为 true。
在 IFRAME 内容源文档，background-color 或 BODY 元素的 BGCOLOR 标签属性必须设置为 transparent。
参看使用透明的浮动框架可以获得关于透明浮动框架更多的信息。

此元素在 Microsoft® Internet Explorer 4.0 的 HTML 和脚本中可用。

此元素是一个块元素。

此元素需要关闭标签。

示例

下面的例子使用了 IFRAME 元素创建了包含页面 sample.htm 的框架。

<IFRAME ID=IFrame1 FRAMEBORDER=0 SCROLLING=NO SRC="sample.htm"></IFRAME>

下面的例子返回了对 IFRAME 包含的文档的 all 集合的引用。

var collAll = document.frames("IFrame1").document.all

标准信息

此对象定义在 HTML 4.0  和万维网协会(W3C)文档对象模型(DOM) 级别 1  中。

参看

使用 IFRAME 元素