Fenced Frame API
HTMLFencedFrameElement 接口表示 Javascript 中的 fencedframe 元素,且提供配置属性。
实例属性
从其父接口 HTMLElement 继承属性。
- HTMLFencedFrameElement.allow
- : 获取并设置对应
<fencedframe>元素的allow属性值,该属性表示内容首次嵌入时应用的权限策略。
- : 获取并设置对应
- HTMLFencedFrameElement.config
- : 一个 FencedFrameConfig 对象,表示 fencedframe 的导航,即其中将显示什么内容。
FencedFrameConfig是从诸如受保护的受众 API 等来源返回的。
- : 一个 FencedFrameConfig 对象,表示 fencedframe 的导航,即其中将显示什么内容。
- HTMLFencedFrameElement.height
- : 获取并设置对应
<fencedframe>元素的height属性的值,该属性指定元素的高度。
- : 获取并设置对应
- HTMLFencedFrameElement.width
- : 获取并设置对应
<fencedframe>元素的width属性的值,该属性指定元素的宽度。
- : 获取并设置对应
示例
要设置将在 <fencedframe> 中显示的内容,使用 API(如受保护的受众或共享存储)生成一个 FencedFrameConfig 对象,然后将其设置为 <fencedframe> 的 config 属性值。
以下示例从受保护的受众 API 的广告拍卖中获取一个 FencedFrameConfig,然后使用它在 <fencedframe> 中显示获胜的广告:
const frameConfig = await navigator.runAdAuction({
// 拍卖配置
resolveToConfig: true,
});
const frame = document.createElement("fencedframe");
frame.config = frameConfig;
[!NOTE] 在调用
runAdAuction()时,必须传入resolveToConfig: true以获得FencedFrameConfig对象。如果没有设置,则所得的 Promise 将兑现为一个 URN,该 URN 只能在 iframe 中使用。
规范
浏览器兼容性
参见
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
