HTMLFencedFrameElement
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates.
Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the <fencedframe> element and related APIs.
Die HTMLFencedFrameElement-Schnittstelle repräsentiert ein <fencedframe>-Element in JavaScript und bietet Konfigurationseigenschaften.
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternobjekt, HTMLElement.
HTMLFencedFrameElement.allow-
Ruft den Wert des entsprechenden
<fencedframe>-allow-Attributs ab und setzt ihn. Dieses Attribut stellt eine Permissions Policy dar, die auf den Inhalt angewendet wird, wenn er erstmals eingebettet wird. HTMLFencedFrameElement.config-
Ein
FencedFrameConfig-Objekt, das die Navigation eines<fencedframe>darstellt, d.h. welchen Inhalt es anzeigt. EinFencedFrameConfigwird aus einer Quelle wie der Protected Audience API zurückgegeben. HTMLFencedFrameElement.height-
Ruft den Wert des entsprechenden
<fencedframe>-height-Attributs ab und setzt ihn. Dieses Attribut gibt die Höhe des Elements an. HTMLFencedFrameElement.width-
Ruft den Wert des entsprechenden
<fencedframe>-width-Attributs ab und setzt ihn. Dieses Attribut gibt die Breite des Elements an.
Beispiele
Um festzulegen, welcher Inhalt in einem <fencedframe> angezeigt wird, wird eine API (wie Protected Audience oder Shared Storage) genutzt, um ein FencedFrameConfig-Objekt zu generieren, das dann als Wert der config-Eigenschaft des <fencedframe> festgelegt wird.
Das folgende Beispiel erhält ein FencedFrameConfig aus einer Anzeigenausschreibung der Protected Audience API, das verwendet wird, um die gewonnene Anzeige in einem <fencedframe> anzuzeigen:
const frameConfig = await navigator.runAdAuction({
// … auction configuration
resolveToConfig: true,
});
const frame = document.createElement("fencedframe");
frame.config = frameConfig;
Spezifikationen
| Spezifikation |
|---|
| Fenced Frame # htmlfencedframeelement |
Browser-Kompatibilität
Siehe auch
- Fenced frames auf privacysandbox.google.com
- The Privacy Sandbox auf privacysandbox.google.com