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 vor der Verwendung auf produktiven Webseiten.
Das HTMLFencedFrameElement
-Interface repräsentiert ein <fencedframe>
-Element in JavaScript und bietet Konfigurationseigenschaften.
Instanzeigenschaften
Erbt Eigenschaften von seinem übergeordneten HTMLElement
.
HTMLFencedFrameElement.allow
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-allow
-Attributs ab und setzt diesen, welches eine Berechtigungsrichtlinie darstellt, die auf den Inhalt angewendet wird, wenn er erstmals eingebettet wird. HTMLFencedFrameElement.config
Experimentell-
Ein
FencedFrameConfig
-Objekt, das die Navigation eines<fencedframe>
darstellt, d.h. welcher Inhalt darin angezeigt wird. EinFencedFrameConfig
wird aus einer Quelle wie der Protected Audience API zurückgegeben. HTMLFencedFrameElement.height
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-height
-Attributs ab und setzt diesen, welches die Höhe des Elements spezifiziert. HTMLFencedFrameElement.width
Experimentell-
Ruft den Wert des entsprechenden
<fencedframe>
-width
-Attributs ab und setzt diesen, welches die Breite des Elements spezifiziert.
Beispiele
Um festzulegen, welcher Inhalt in einem <fencedframe>
angezeigt wird, generiert eine verwendende API (wie Protected Audience oder Shared Storage) ein FencedFrameConfig
-Objekt, das dann als Wert der config
-Eigenschaft des <fencedframe>
gesetzt wird.
Im folgenden Beispiel wird ein FencedFrameConfig
von einer Anzeigenauktion der Protected Audience API abgerufen und dann verwendet, 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;
Note:
resolveToConfig: true
muss bei dem Aufruf vonrunAdAuction()
übergeben werden, um einFencedFrameConfig
-Objekt zu erhalten. Wenn es nicht gesetzt wird, wird die resultierendePromise
auf einen URN aufgelöst, der nur in einem<iframe>
verwendet werden kann.
Spezifikationen
Specification |
---|
Fenced Frame # htmlfencedframeelement |
Browser-Kompatibilität
Siehe auch
- Fenced frames auf developers.google.com
- The Privacy Sandbox auf developers.google.com