大网数据广告活动
Web 标准与前端开发

HTMLFencedFrameElement

· 52CE 我爱测

`HTMLFencedFrameElement`** 接口表示 Javascript 中的 fencedframe 元素,且提供配置属性。

Fenced Frame API

HTMLFencedFrameElement 接口表示 Javascript 中的 fencedframe 元素,且提供配置属性。

实例属性

从其父接口 HTMLElement 继承属性。

  • HTMLFencedFrameElement.allow
    • : 获取并设置对应 <fencedframe> 元素的 allow 属性值,该属性表示内容首次嵌入时应用的权限策略。
  • HTMLFencedFrameElement.config
    • : 一个 FencedFrameConfig 对象,表示 fencedframe 的导航,即其中将显示什么内容。FencedFrameConfig 是从诸如受保护的受众 API 等来源返回的。
  • 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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。