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.

Die HTMLFencedFrameElement-Schnittstelle repräsentiert ein <fencedframe>-Element in JavaScript und bietet Konfigurationseigenschaften.

EventTarget Node Element HTMLElement HTMLFencedFrameElement

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. Ein FencedFrameConfig 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:

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

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

Note: resolveToConfig: true muss im Aufruf von runAdAuction() übergeben werden, um ein FencedFrameConfig-Objekt zu erhalten. Wenn es nicht gesetzt ist, wird die resultierende Promise in eine URN aufgelöst, die nur in einem <iframe> verwendet werden kann.

Spezifikationen

Specification
Fenced Frame
# htmlfencedframeelement

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLFencedFrameElement
Experimental
allow
Experimental
config
Experimental
height
Experimental
sandbox
Experimental
width
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.

Siehe auch