HTMLIFrameElement - 操作 <iframe> 元素

HTMLIFrameElement 接口提供了特殊的属性和方法（除了通过继承通用的 HTMLElement 接口获得的常规属性和方法）来操作内联框架元素的布局和展示。

属性

从其父类 HTMLElement 继承了属性。

HTMLIFrameElement.align

一个 DOMString，它指定框架相对于周围上下文的对齐方式。

HTMLIFrameElement.allow

允许框架显示内容的源的列表。该属性还接受值 self 和 src，它们表示 iframe 的 src 属性中的源。默认值为 src。

HTMLIFrameElement.allowfullscreen

一个 Boolean，指示内联框架是否允许进入全屏模式。有关详细信息，请参阅使用全屏模式。

HTMLIFrameElement.allowPaymentRequest

一个 Boolean，指示是否可以在跨源 iframe 内调用 Payment Request API。

HTMLIFrameElement.contentDocument 只读

返回一个 Document，它是内联框架嵌套浏览上下文中的活动文档。

HTMLIFrameElement.contentWindow 只读

返回一个 WindowProxy，它是嵌套浏览上下文的窗口代理。

HTMLIFrameElement.csp

指定嵌入式文档必须同意对其自身强制执行的内容安全策略。

HTMLIFrameElement.frameBorder

一个 DOMString，指示是否在框架之间创建边框。

HTMLIFrameElement.height

一个 DOMString，它反映了 height HTML 属性，指示了框架的高度。

HTMLIFrameElement.longDesc

一个 DOMString，它包含框架的长描述的 URI。

HTMLIFrameElement.marginHeight

一个 DOMString，表示框架边距的高度。

HTMLIFrameElement.marginWidth

一个 DOMString，表示框架边距的宽度。

HTMLIFrameElement.name

一个 DOMString，它反映了 name HTML 属性，包含用于引用框架的名称。

HTMLIFrameElement.policy 只读

返回 Policy 接口，该接口提供了一个简单的 API，用于内省应用于特定文档的功能策略。

HTMLIFrameElement.referrerPolicy

一个 DOMString，它反映了 referrerpolicy HTML 属性，指示在获取链接资源时使用哪个引用者。

HTMLIFrameElement.sandbox

一个 DOMSettableTokenList，它反映了 sandbox HTML 属性，表示对嵌套内容行为的额外限制。

HTMLIFrameElement.scrolling

一个 DOMString，指示浏览器是否应为框架提供滚动条。

HTMLIFrameElement.src

一个 DOMString，它反映了 src HTML 属性，包含要嵌入的内容的地址。请注意，在 Firefox（从版本 65 开始），基于 Chromium 的浏览器和 Safari/iOS）中，以编程方式删除 <iframe> 的 src 属性（例如，通过 Element.removeAttribute()）会导致框架加载 about:blank。

HTMLIFrameElement.srcdoc

一个 DOMString，表示要在框架中显示的内容。

HTMLIFrameElement.width

一个 DOMString，它反映了 width HTML 属性，表示框架的宽度。

方法

从其父类 HTMLElement 继承了方法。

规范 状态 备注
HTML Living Standard
HTMLIFrameElement 的定义		 现行的标准 增加了以下属性：allowFullscreen。
HTML5
HTMLIFrameElement 的定义		 推荐 以下属性现已过时：scrolling ，marginWidth，marginHeight，longDesc，frameBorder 和 align。
增加了以下属性：srcdoc，sandbox 和 contentWindow。
Document Object Model (DOM) Level 2 HTML Specification
HTMLIFrameElement 的定义		 已过时 添加了 contentDocument 属性。
Document Object Model (DOM) Level 1 Specification
HTMLIFrameElement 的定义		 已过时 初始定义。

桌面浏览器兼容性

特性ChromeEdgeFirefoxInternet ExplorerOperaSafari
基础支持 支持 支持1 支持 支持 支持
addNextPaintListener 不支持 不支持471 不支持 不支持 不支持
align43 支持 支持 未知 支持6
allow60 未知 未知 未知53 未知
allowFullScreen17 webkit 2 支持

18

9 moz

不支持 不支持 不支持
allowPaymentRequest601556 未知 不支持 未知
clearMatch 不支持 不支持471 不支持 不支持 不支持
contentDocument43 支持 支持8 支持10
contentWindow43 支持 支持 支持 支持6
csp61 未知 未知 未知48 未知
download 不支持 不支持471 不支持 不支持 不支持
executeScript 不支持 不支持471 不支持 不支持 不支持
findAll 不支持 不支持471 不支持 不支持 不支持
findNext 不支持 不支持471 不支持 不支持 不支持
frameBorder43 支持 支持 未知 支持6
getActive 不支持 不支持471 不支持 不支持 不支持
getCanGoBack 不支持 不支持471 不支持 不支持 不支持
getCanGoForward 不支持 不支持471 不支持 不支持 不支持
getContentDimensions 不支持 不支持471 不支持 不支持 不支持
getManifest 不支持 不支持471 不支持 不支持 不支持
getMuted 不支持 不支持471 不支持 不支持 不支持
getScreenshot 不支持 不支持471 不支持 不支持 不支持
getStructuredData 不支持 不支持471 不支持 不支持 不支持
getVisible 不支持 不支持471 不支持 不支持 不支持
getVolume 不支持 不支持471 不支持 不支持 不支持
goBack 不支持 不支持471 不支持 不支持 不支持
goForward 不支持 不支持471 不支持 不支持 不支持
height43 支持 支持 未知 支持6
longDesc43 支持 支持 未知 支持6
marginHeight43 支持 支持 未知 支持6
marginWidth43 支持 支持 未知 支持6
mute 不支持 不支持471 不支持 不支持 不支持
name43 支持 支持 未知 支持6
purgeHistory 不支持 不支持471 不支持 不支持 不支持
referrerPolicy53 未知50 未知38 未知
reload 不支持 不支持471 不支持 不支持 不支持
removeNextPaintListener 不支持 不支持471 不支持 不支持 不支持
sandbox43 支持173 未知 未知6
scrolling43 支持 支持 未知 支持6
sendMouseEvent 不支持 不支持471 不支持 不支持 不支持
sendTouchEvent 不支持 不支持471 不支持 不支持 不支持
setActive 不支持 不支持471 不支持 不支持 不支持
setVisible 不支持 不支持471 不支持 不支持 不支持
setVolume 不支持 不支持471 不支持 不支持 不支持
src43 支持 支持 未知 未知6
srcdoc43 支持25 不支持 未知6
stop 不支持 不支持471 不支持 不支持 不支持
unmute 不支持 不支持471 不支持 不支持 不支持
width43 支持 支持 未知 支持6
zoom 不支持 不支持471 不支持 不支持 不支持

移动浏览器兼容性

特性AndroidChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
基础支持 支持 支持 支持4 未知 支持 未知
addNextPaintListener 不支持 不支持 不支持 不支持 未知 不支持 不支持
align 支持 支持 未知 未知 未知 支持 未知
allow6666 未知 未知 未知53 未知
allowFullScreen17 webkit 217 webkit 2 支持

18

9 moz

未知 不支持 未知
allowPaymentRequest 不支持61 未知 未知 未知 不支持 未知
clearMatch 不支持 不支持 不支持 不支持 未知 不支持 不支持
contentDocument 支持 支持 未知4 未知 支持 支持
contentWindow 支持 支持 支持 支持 未知 支持 支持
csp6161 未知 未知 未知48 未知
download 不支持 不支持 不支持 不支持 未知 不支持 不支持
executeScript 不支持 不支持 不支持 不支持 未知 不支持 不支持
findAll 不支持 不支持 不支持 不支持 未知 不支持 不支持
findNext 不支持 不支持 不支持 不支持 未知 不支持 不支持
frameBorder 支持 支持 未知 未知 未知 支持 未知
getActive 不支持 不支持 不支持 不支持 未知 不支持 不支持
getCanGoBack 不支持 不支持 不支持 不支持 未知 不支持 不支持
getCanGoForward 不支持 不支持 不支持 不支持 未知 不支持 不支持
getContentDimensions 不支持 不支持 不支持 不支持 未知 不支持 不支持
getManifest 不支持 不支持 不支持 不支持 未知 不支持 不支持
getMuted 不支持 不支持 不支持 不支持 未知 不支持 不支持
getScreenshot 不支持 不支持 不支持 不支持 未知 不支持 不支持
getStructuredData 不支持 不支持 不支持 不支持 未知 不支持 不支持
getVisible 不支持 不支持 不支持 不支持 未知 不支持 不支持
getVolume 不支持 不支持 不支持 不支持 未知 不支持 不支持
goBack 不支持 不支持 不支持 不支持 未知 不支持 不支持
goForward 不支持 不支持 不支持 不支持 未知 不支持 不支持
height 支持 支持 未知 未知 未知 支持 未知
longDesc 支持 支持 未知 未知 未知 支持 未知
marginHeight 支持 支持 未知 未知 未知 支持 未知
marginWidth 支持 支持 未知 未知 未知 支持 未知
mute 不支持 不支持 不支持 不支持 未知 不支持 不支持
name 支持 支持 未知 未知 未知 支持 未知
purgeHistory 不支持 不支持 不支持 不支持 未知 不支持 不支持
referrerPolicy5151 未知50 未知38 未知
reload 不支持 不支持 不支持 不支持 未知 不支持 不支持
removeNextPaintListener 不支持 不支持 不支持 不支持 未知 不支持 不支持
sandbox44 支持173 未知 未知 未知
scrolling 支持 支持 未知 未知 未知 支持 未知
sendMouseEvent 不支持 不支持 不支持 不支持 未知 不支持 不支持
sendTouchEvent 不支持 不支持 不支持 不支持 未知 不支持 不支持
setActive 不支持 不支持 不支持 不支持 未知 不支持 不支持
setVisible 不支持 不支持 不支持 不支持 未知 不支持 不支持
setVolume 不支持 不支持 不支持 不支持 未知 不支持 不支持
src 支持 支持 未知 未知 未知 未知 未知
srcdoc44 支持25 未知 未知 未知
stop 不支持 不支持 不支持 不支持 未知 不支持 不支持
unmute 不支持 不支持 不支持 不支持 未知 不支持 不支持
width 支持 支持 未知 未知 未知 支持 未知
zoom 不支持 不支持 不支持 不支持 未知 不支持 不支持

1. 仅支持 chrome 代码。

2. 仅在每日测试构建中。

3. 以前，sandbox 的类型是 DOMString 而不是 DOMSettableTokenList。这已经在 Firefox 29 中得到修复。其他浏览器仍然可以将该属性实现为 DOMString，因为它是规范中的后期更改。

相关链接

  • 实现该接口的 HTML 元素：<iframe>