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

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLFencedFrameElement.allow Experimentell

Ruft den Wert des entsprechenden <fencedframe>-allow-Attributs ab und setzt ihn, 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. welche Inhalte darin angezeigt werden. 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 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 nützliche API (wie z. B. Protected Audience oder Shared Storage) ein FencedFrameConfig-Objekt, das dann als Wert der config-Eigenschaft des <fencedframe> gesetzt wird.

Das folgende Beispiel erhält ein FencedFrameConfig von einer Anzeigenauktion der Protected Audience API, das 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;

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

Spezifikationen

Specification
Fenced Frame
# htmlfencedframeelement

Browser-Kompatibilität

Siehe auch