HTMLFencedFrameElement
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Die HTMLFencedFrameElement
-Schnittstelle repräsentiert ein <fencedframe>
-Element in JavaScript und bietet Konfigurationseigenschaften.
Instanzeigenschaften
Erbt Eigenschaften von seinem Elternteil, HTMLElement
.
HTMLFencedFrameElement.allow
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-allow
-Attributs ab und setzt ihn. Dieses Attribut stellt eine Berechtigungsrichtlinie dar, die auf den Inhalt angewendet wird, wenn dieser erstmalig eingebettet wird. HTMLFencedFrameElement.config
Experimentell-
Ein
FencedFrameConfig
-Objekt, das die Navigation eines<fencedframe>
darstellt, d.h. welchen Inhalt es zeigen wird. EinFencedFrameConfig
wird von einer Quelle wie der Protected Audience API zurückgegeben. HTMLFencedFrameElement.height
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-height
-Attributs ab und setzt ihn, welches die Höhe des Elements angibt. HTMLFencedFrameElement.width
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-width
-Attributs ab und setzt ihn, welches die Breite des Elements angibt.
Beispiele
Um festzulegen, welcher Inhalt in einem <fencedframe>
angezeigt wird, generiert eine API (wie z. B. Protected Audience oder Shared Storage) ein FencedFrameConfig
-Objekt, das dann als Wert der config
-Eigenschaft des <fencedframe>
festgelegt wird.
Das folgende Beispiel erhält eine FencedFrameConfig
von einer Anzeigenauktion der Protected Audience API, die dann verwendet wird, um die gewinnende Anzeige in einem <fencedframe>
anzuzeigen:
const frameConfig = await navigator.runAdAuction({
// ...auction configuration
resolveToConfig: true,
});
const frame = document.createElement("fencedframe");
frame.config = frameConfig;
Note:
resolveToConfig: true
muss im Aufruf vonrunAdAuction()
übergeben werden, um einFencedFrameConfig
-Objekt zu erhalten. Wenn es nicht gesetzt ist, wird die resultierendePromise
in eine URN aufgelöst, die nur in einem<iframe>
verwendet werden kann.
Spezifikationen
Specification |
---|
Fenced Frame # htmlfencedframeelement |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- Fenced frames auf developers.google.com
- The Privacy Sandbox auf developers.google.com