HTMLFencedFrameElement

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

实验性: 这是一项实验性技术
在生产中使用此技术之前,请仔细检查浏览器兼容性表格

HTMLFencedFrameElement 接口表示 JavaScript 中的 <fencedframe> 元素,并提供配置属性。

EventTarget Node Element HTMLElement HTMLFencedFrameElement

实例属性

继承自其父级 HTMLElement 的属性。

HTMLFencedFrameElement.allow 实验性

获取和设置相应的 <fencedframe> allow 属性的值。该属性表示在内容首次嵌入时应用的 权限策略

HTMLFencedFrameElement.config 实验性

一个 FencedFrameConfig 对象,它代表 <fencedframe> 的导航,即将在其中显示的内容。FencedFrameConfig 可以从 Protected Audience API 等来源获取。

HTMLFencedFrameElement.height 实验性

获取和设置相应的 <fencedframe> height 属性的值,该属性指定元素的高度。

HTMLFencedFrameElement.width 实验性

获取和设置相应的 <fencedframe> width 属性的值,该属性指定元素的宽度。

示例

要设置 <fencedframe> 中将显示的内容,使用的 API(例如 Protected AudienceShared Storage)会生成一个 FencedFrameConfig 对象,然后将其设置为 <fencedframe>config 属性的值。

以下示例从 Protected Audience API 的广告竞价中获取一个 FencedFrameConfig,然后用于在 <fencedframe> 中显示中标广告

js
const frameConfig = await navigator.runAdAuction({
  // … auction configuration
  resolveToConfig: true,
});

const frame = document.createElement("fencedframe");
frame.config = frameConfig;

注意:必须将 resolveToConfig: true 传递给 runAdAuction() 调用才能获取 FencedFrameConfig 对象。如果未设置,结果的Promise 将解析为一个 URN,该 URN 只能在<iframe> 中使用。

规范

规范
围栏框架
# htmlfencedframeelement

浏览器兼容性

另见