HTMLIFrameElement

Baseline 广泛可用 *

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

HTMLIFrameElement 接口提供了用于操作内嵌框架(inline frame)元素的布局和显示的特殊属性和方法(除了通过继承获得的 HTMLElement 接口的属性和方法)。

EventTarget Node Element HTMLElement HTMLIFrameElement

实例属性

继承其父级 HTMLElement 的属性。.

HTMLIFrameElement.align 已弃用

一个字符串,指定框架相对于周围上下文的对齐方式。

HTMLIFrameElement.allow

一个字符串,指示为该 <iframe> 指定的 权限策略(Permissions Policy)

HTMLIFrameElement.allowFullscreen

一个布尔值,指示内嵌框架是否愿意进入全屏模式。有关详细信息,请参阅 使用全屏模式

HTMLIFrameElement.allowPaymentRequest 已弃用 非标准

一个布尔值,指示是否允许在跨域 iframe 中调用 Payment Request API

HTMLIFrameElement.browsingTopics 实验性 非标准

一个布尔属性,指定应将当前用户的选定主题与相关 <iframe> 源的请求一起发送。这反映了 browsingtopics 内容属性的值。

HTMLIFrameElement.contentDocument 只读

返回一个 Document 对象,即内嵌框架嵌套浏览上下文中的活动文档。

HTMLIFrameElement.contentWindow 只读

返回一个 WindowProxy 对象,即嵌套浏览上下文的窗口代理。

HTMLIFrameElement.credentialless 实验性

一个布尔值,指示 <iframe> 是否为无凭证模式(credentialless),意味着其内容在一个新的、临时的上下文中加载。此上下文无法访问父上下文的共享存储和凭证。作为回报,可以解除 Cross-Origin-Embedder-Policy (COEP) 嵌入规则,因此设置了 COEP 的文档可以嵌入未设置 COEP 的第三方文档。有关更深入的解释,请参阅 IFrame credentialless

HTMLIFrameElement.csp 实验性

指定一个内容安全策略(Content Security Policy),嵌入的文档必须同意强制执行该策略。

HTMLIFrameElement.featurePolicy 只读 实验性

返回 FeaturePolicy 接口,该接口提供了一个简单的 API 来检查应用于特定文档的 权限策略(Permissions Policies)

HTMLIFrameElement.frameBorder 已弃用

一个字符串,指示是否在框架之间创建边框。

HTMLIFrameElement.height

一个字符串,反映了 height HTML 属性,表示框架的高度。

HTMLIFrameElement.loading

一个字符串,为浏览器提供提示,说明 iframe 应立即加载(eager)还是按需加载(lazy)。这反映了 loading HTML 属性。

HTMLIFrameElement.longDesc 已弃用

一个字符串,包含框架长描述的 URI。

HTMLIFrameElement.marginHeight 已弃用

一个字符串,表示框架边距的高度。

HTMLIFrameElement.marginWidth 已弃用

一个字符串,表示框架边距的宽度。

HTMLIFrameElement.name

一个字符串,反映了 name HTML 属性,其中包含用于引用框架的名称。

HTMLIFrameElement.referrerPolicy

一个字符串,反映了 referrerPolicy HTML 属性,指示在获取链接资源时应使用的引用者(referrer)策略。

HTMLIFrameElement.sandbox 只读

返回一个 DOMTokenList 对象,该对象反映了 sandbox HTML 属性,指示对嵌套内容的行为施加的额外限制。

HTMLIFrameElement.scrolling 已弃用

一个字符串,指示浏览器是否应为框架提供滚动条。

HTMLIFrameElement.src

一个字符串,反映了 src HTML 属性,其中包含要嵌入的内容的地址。请注意,在 Firefox(从 65 版开始)、基于 Chromium 的浏览器以及 Safari/iOS 中,通过编程方式移除 <iframe> 的 src 属性(例如使用 Element.removeAttribute())会导致在框架中加载 about:blank

HTMLIFrameElement.srcdoc

一个 TrustedHTML 对象或字符串,表示加载到框架中的 HTML 文档。

HTMLIFrameElement.width

一个字符串,反映了 width HTML 属性,表示框架的宽度。

实例方法

它还继承了其父接口 HTMLElement 的方法。

HTMLIFrameElement.getSVGDocument()

Document 对象形式返回嵌入的 SVG。

规范

规范
HTML
# htmliframeelement

浏览器兼容性

另见

  • 实现此接口的 HTML 元素:<iframe>