Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

Instanz-Eigenschaften

Erbt Eigenschaften von seinem Elternteil, HTMLElement.

HTMLFencedFrameElement.allow Experimentell

Ruft den Wert des entsprechenden <fencedframe> allow-Attributs ab und setzt diesen, das 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 von einer Quelle wie der Protected Audience API zurückgegeben.

HTMLFencedFrameElement.height Experimentell

Ruft den Wert des entsprechenden <fencedframe> height-Attributs ab und setzt diesen, der die Höhe des Elements angibt.

HTMLFencedFrameElement.width Experimentell

Ruft den Wert des entsprechenden <fencedframe> width-Attributs ab und setzt diesen, der die Breite des Elements angibt.

Beispiele

Um den Inhalt festzulegen, der in einem <fencedframe> angezeigt wird, erzeugt eine nutzende API (wie 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 aus einer Anzeigenauktion der Protected Audience API, das dann verwendet wird, 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;

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

Spezifikationen

Specification
Fenced Frame
# htmlfencedframeelement

Browser-Kompatibilität

Siehe auch