HTMLFencedFrameElement

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.

Giao diện HTMLFencedFrameElement đại diện cho phần tử <fencedframe> trong JavaScript và cung cấp các thuộc tính cấu hình.

EventTarget Node Element HTMLElement HTMLFencedFrameElement

Thuộc tính phiên bản

Kế thừa các thuộc tính từ cha, HTMLElement.

HTMLFencedFrameElement.allow Experimental

Lấy và đặt giá trị của thuộc tính allow của <fencedframe> tương ứng, đại diện cho Chính sách Quyền được áp dụng cho nội dung khi lần đầu nhúng vào.

HTMLFencedFrameElement.config Experimental

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.

HTMLFencedFrameElement.height Experimental

Lấy và đặt giá trị của thuộc tính height của <fencedframe> tương ứng, chỉ định chiều cao của phần tử.

HTMLFencedFrameElement.width Experimental

Lấy và đặt giá trị của thuộc tính width của <fencedframe> tương ứng, chỉ định chiều rộng của phần tử.

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>:

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

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

Note: resolveToConfig: true phải được truyền vào lệnh gọi runAdAuction() để nhận đối tượng FencedFrameConfig. Nếu không đặt, Promise kết quả sẽ phân giải thành URN chỉ có thể được sử dụng trong <iframe>.

Thông số kỹ thuật

Specification
Fenced Frame
# htmlfencedframeelement

Tương thích trình duyệt

Xem thêm