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.

EventTarget Node Element HTMLElement HTMLFencedFrameElement

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

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

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

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

Spezifikationen

Specification
Fenced Frame
# htmlfencedframeelement

Browser-Kompatibilität

Siehe auch