HTMLIFrameElement
interface provides special properties and methods (beyond those of the
HTMLElement
interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements.
<div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 20%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 120" preserveAspectRatio="xMinYMin meet"><a xlink:href="../API/EventTarget.html" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25 121,20 121,30 111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25 236,20 236,30 226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25 351,20 351,30 341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="../API/HTMLElement" target="_top"><rect x="381" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text x="436" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLElement</text></a><polyline points="491,25 501,20 501,30 491,25" stroke="#D4DDE4" fill="none"/><line x1="501" y1="25" x2="509" y2="25" stroke="#D4DDE4"/><line x1="509" y1="25" x2="509" y2="90" stroke="#D4DDE4"/><line x1="509" y1="90" x2="492" y2="90" stroke="#D4DDE4"/><a xlink:href="../API/HTMLIFrameElement" target="_top"><rect x="321" y="65" width="170" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text x="406" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">HTMLIFrameElement</text></a></svg></div>
a:hover text { fill: #0095DD; pointer-events: all;}
继承的特性来自其父级,
HTMLElement
.
HTMLIFrameElement.align
DOMString
that specifies the alignment of the frame with respect to the surrounding context.
HTMLIFrameElement.allow
self
and
src
which represent the origin in the iframe's src attribute. The default value is
src
.
HTMLIFrameElement.allowfullscreen
布尔
indicating whether the inline frame is willing to be placed into full screen mode. See
使用全屏模式
了解细节。
HTMLIFrameElement.allowPaymentRequest
布尔
indicating whether the
支付请求 API
may be invoked inside a cross-origin iframe.
HTMLIFrameElement.contentDocument
只读
Document
, the active document in the inline frame's nested browsing context.
HTMLIFrameElement.contentWindow
只读
WindowProxy
, the window proxy for the nested browsing context.
HTMLIFrameElement.csp
Specifies the Content Security Policy that an embedded document must agree to enforce upon itself.
HTMLIFrameElement.frameBorder
DOMString
that indicates whether to create borders between frames.
HTMLIFrameElement.height
DOMString
that reflects the
height
HTML attribute, indicating the height of the frame.
HTMLIFrameElement.longDesc
DOMString
that contains the URI of a long description of the frame.
HTMLIFrameElement.marginHeight
DOMString
being the height of the frame margin.
HTMLIFrameElement.marginWidth
DOMString
being the width of the frame margin.
HTMLIFrameElement.name
DOMString
that reflects the
名称
HTML attribute, containing a name by which to refer to the frame.
HTMLIFrameElement.featurePolicy
只读
FeaturePolicy
接口,提供简单 API 用于自省被应用于特定文档的特征策略。
HTMLIFrameElement.referrerPolicy
DOMString
that reflects the
referrerpolicy
HTML attribute indicating which referrer to use when fetching the linked resource.
HTMLIFrameElement.sandbox
DOMSettableTokenList
that reflects the
sandbox
HTML attribute, indicating extra restrictions on the behavior of the nested content.
HTMLIFrameElement.scrolling
DOMString
that indicates whether the browser should provide scrollbars for the frame.
HTMLIFrameElement.src
DOMString
that reflects the
src
HTML attribute, containing the address of the content to be embedded. Note that programatically removing an
<iframe>
's src attribute (e.g. via
Element.removeAttribute()
) causes
about:blank
to be loaded in the frame in Firefox (from version 65), Chromium-based browsers, and Safari/iOS.
HTMLIFrameElement.srcdoc
DOMString
that represents the content to display in the frame.
HTMLIFrameElement.width
DOMString
that reflects the
width
HTML attribute, indicating the width of the frame.
继承的特性来自其父级,
HTMLElement
.
| 规范 | 状态 | 注释 |
|---|---|---|
|
HTML 实时标准
The definition of 'HTMLIFrameElement' in that specification. |
实时标准 |
The following property has been added:
allowFullscreen
.
|
|
HTML5
The definition of 'HTMLIFrameElement' in that specification. |
推荐 |
The following properties are now obsolete:
scrolling
,
marginWidth
,
marginHeight
,
longDesc
,
frameBorder
,和
align
.
The following properties have been added:
srcdoc
,
sandbox
,和
contentWindow
.
|
|
DOM (文档对象模型) 2 级 HTML 规范
The definition of 'HTMLIFrameElement' in that specification. |
过时 |
contentDocument
property has been added.
|
|
DOM (文档对象模型) 1 级规范
The definition of 'HTMLIFrameElement' in that specification. |
过时 | 初始定义。 |
| 桌面 | 移动 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
HTMLIFrameElement
|
Chrome Yes | Edge 12 | Firefox 1 | IE Yes | Opera Yes | Safari Yes | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
align
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
allow
|
Chrome 60 | Edge ≤79 | Firefox 74 | IE ? | Opera 53 | Safari Yes | WebView Android 66 | Chrome Android 66 | Firefox Android 不支持 No | Opera Android 47 | Safari iOS Yes | Samsung Internet Android 9.0 |
allowFullscreen
|
Chrome 38 | Edge ≤18 |
Firefox
22
|
IE 不支持 No | Opera 25 | Safari 10 | WebView Android 38 | Chrome Android 38 |
Firefox Android
22
|
Opera Android 25 | Safari iOS 10 | Samsung Internet Android 3.0 |
allowPaymentRequest
|
Chrome
60
Disabled
|
Edge 15 | Firefox 56 | IE ? | Opera 不支持 No | Safari ? | WebView Android 不支持 No |
Chrome Android
61
Disabled
|
Firefox Android Yes | Opera Android 不支持 No | Safari iOS ? | Samsung Internet Android 不支持 No |
contentDocument
|
Chrome 43 | Edge 12 | Firefox Yes | IE 8 | Opera Yes | Safari 10 | WebView Android Yes | Chrome Android Yes | Firefox Android 4 | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
contentWindow
|
Chrome 1 | Edge 12 | Firefox 1 | IE 8 | Opera 8 | Safari 3 | WebView Android 1 | Chrome Android 18 | Firefox Android 4 | Opera Android 10.1 | Safari iOS 1 | Samsung Internet Android 1.0 |
csp
|
Chrome 61 | Edge ≤79 | Firefox ? | IE ? | Opera 48 | Safari ? | WebView Android 61 | Chrome Android 61 | Firefox Android ? | Opera Android 45 | Safari iOS ? | Samsung Internet Android 8.0 |
featurePolicy
|
Chrome
74
注意事项
|
Edge
79
注意事项
|
Firefox
69
Disabled
|
IE 不支持 No |
Opera
62
|
Safari 不支持 No |
WebView Android
74
注意事项
|
Chrome Android
74
注意事项
|
Firefox Android
65
Alternate Name
Disabled
|
Opera Android
48
Alternate Name
Disabled
|
Safari iOS 不支持 No | Samsung Internet Android 11.0 |
frameBorder
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
height
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
longDesc
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
marginHeight
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
marginWidth
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
名称
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
referrerPolicy
|
Chrome 51 | Edge 79 | Firefox 50 | IE 不支持 No | Opera 38 | Safari 11.1 | WebView Android 51 | Chrome Android 51 | Firefox Android 50 | Opera Android 41 | Safari iOS 不支持 No | Samsung Internet Android 5.0 |
sandbox
|
Chrome
43
注意事项
|
Edge 12 |
Firefox
17
注意事项
|
IE ? |
Opera
Yes
注意事项
|
Safari 6 |
WebView Android
Yes
注意事项
|
Chrome Android
18
注意事项
|
Firefox Android
17
注意事项
|
Opera Android
Yes
注意事项
|
Safari iOS Yes |
Samsung Internet Android
1.0
注意事项
|
scrolling
弃用
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
setNfcFocus
非标
|
Chrome 不支持 No | Edge 不支持 No |
Firefox
不支持
No
注意事项
|
IE 不支持 No | Opera 不支持 No | Safari 不支持 No | WebView Android 不支持 No | Chrome Android 不支持 No | Firefox Android 不支持 No | Opera Android 不支持 No | Safari iOS 不支持 No | Samsung Internet Android 不支持 No |
src
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
srcdoc
|
Chrome 43 | Edge 79 | Firefox 25 | IE 不支持 No | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android 18 | Firefox Android 25 | Opera Android Yes | Safari iOS Yes | Samsung Internet Android 1.0 |
width
|
Chrome 43 | Edge 12 | Firefox Yes | IE ? | Opera Yes | Safari 6 | WebView Android Yes | Chrome Android Yes | Firefox Android Yes | Opera Android Yes | Safari iOS Yes | Samsung Internet Android Yes |
完整支持
不支持
兼容性未知
实验。期望将来行为有所改变。
非标。预期跨浏览器支持较差。
弃用。不要用于新网站。
见实现注意事项。
用户必须明确启用此特征。
使用非标名称。
<iframe>
HTMLIFrameElement
BeforeUnloadEvent
DOMStringMap
ErrorEvent
GlobalEventHandlers
HTMLAnchorElement
HTMLAreaElement
HTMLAudioElement
HTMLBRElement
HTMLBaseElement
HTMLBaseFontElement
HTMLBodyElement
HTMLButtonElement
HTMLCanvasElement
HTMLContentElement
HTMLDListElement
HTMLDataElement
HTMLDataListElement
HTMLDialogElement
HTMLDivElement
HTMLDocument
HTMLElement
HTMLEmbedElement
HTMLFieldSetElement
HTMLFormControlsCollection
HTMLFormElement
HTMLFrameSetElement
HTMLHRElement
HTMLHeadElement
HTMLHeadingElement
HTMLHtmlElement
HTMLImageElement
HTMLInputElement
HTMLIsIndexElement
HTMLKeygenElement
HTMLLIElement
HTMLLabelElement
HTMLLegendElement
HTMLLinkElement
HTMLMapElement
HTMLMediaElement
HTMLMetaElement
HTMLMeterElement
HTMLModElement
HTMLOListElement
HTMLObjectElement
HTMLOptGroupElement
HTMLOptionElement
HTMLOptionsCollection
HTMLOutputElement
HTMLParagraphElement
HTMLParamElement
HTMLPictureElement
HTMLPreElement
HTMLProgressElement
HTMLQuoteElement
HTMLScriptElement
HTMLSelectElement
HTMLShadowElement
HTMLSourceElement
HTMLSpanElement
HTMLStyleElement
HTMLTableCaptionElement
HTMLTableCellElement
HTMLTableColElement
HTMLTableDataCellElement
HTMLTableElement
HTMLTableHeaderCellElement
HTMLTableRowElement
HTMLTableSectionElement
HTMLTemplateElement
HTMLTextAreaElement
HTMLTimeElement
HTMLTitleElement
HTMLTrackElement
HTMLUListElement
HTMLUnknownElement
HTMLVideoElement
HashChangeEvent
历史
ImageData
定位
MessageChannel
MessageEvent
MessagePort
Navigator
NavigatorGeolocation
NavigatorID
NavigatorLanguage
NavigatorOnLine
NavigatorPlugins
PageTransitionEvent
Plugin
PluginArray
PopStateEvent
PortCollection
PromiseRejectionEvent
RadioNodeList
Transferable
ValidityState
Window
WindowBase64
WindowEventHandlers
WindowTimers