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

BCD tables only load in the browser

Siehe auch