HTMLFencedFrameElement: config property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Thuộc tính config của HTMLFencedFrameElement chứa một đối tượng FencedFrameConfig, đại diện cho điều hướng của <fencedframe>, tức là nội dung nào sẽ được hiển thị trong đó. FencedFrameConfig được trả về từ một nguồn như Protected Audience API.
Giá trị
Giá trị của config ban đầu là null.
Khi giá trị được đặt thành một đối tượng FencedFrameConfig, các thuộc tính nội bộ của FencedFrameConfig (ví dụ mappedURL) xác định những gì được tải bên trong <fencedframe> liên kết. Ngoài ra:
- Loại điều hướng sẽ là
"replace"(xemNavigateEvent.navigationType), nghĩa là mục lịch sử hiện tại được thay thế bằng mục mới, thay vì thêm mục lịch sử mới. Referrer-Policycủa điều hướng được đặt thành"no-referrer".
Ví dụ
Để đặt nội dung nào sẽ hiển thị trong <fencedframe>, một API sử dụng (như Protected Audience hoặc Shared Storage) tạo ra đối tượng FencedFrameConfig, sau đó được đặt làm giá trị của thuộc tính config của <fencedframe>.
Ví dụ sau lấy FencedFrameConfig từ phiên đấu giá quảng cáo của Protected Audience API, sau đó được sử dụng để hiển thị quảng cáo thắng cuộc trong <fencedframe>:
const frameConfig = await navigator.runAdAuction({
// … auction configuration
resolveToConfig: true,
});
const frame = document.createElement("fencedframe");
frame.config = frameConfig;
Thông số kỹ thuật
| Specification |
|---|
| Fenced Frame # dom-htmlfencedframeelement-config |
Tương thích trình duyệt
Xem thêm
- Fenced frames trên privacysandbox.google.com
- The Privacy Sandbox trên privacysandbox.google.com