HTMLFencedFrameElement: config-Eigenschaft

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die config-Eigenschaft des HTMLFencedFrameElement enthält ein FencedFrameConfig-Objekt, das die Navigation eines <fencedframe> repräsentiert, also den Inhalt, der darin angezeigt wird. Ein FencedFrameConfig wird von einer Quelle wie der Protected Audience API zurückgegeben.

In diesem Artikel

Wert

Der Wert von config ist zunächst null.

Wenn sein Wert auf eine Instanz eines FencedFrameConfig-Objekts gesetzt ist, bestimmen die internen Eigenschaften des FencedFrameConfig (zum Beispiel mappedURL), was innerhalb des zugehörigen <fencedframe> geladen wird. Zusätzlich:

Der Navigationstyp wird "replace" sein (siehe NavigateEvent.navigationType), was bedeutet, dass der aktuelle Verlaufseintrag durch den neuen Eintrag ersetzt wird, anstatt einen neuen Verlaufseintrag hinzuzufügen.
Die Referrer-Policy der Navigation ist auf "no-referrer" gesetzt.

Beispiele

Um festzulegen, welcher Inhalt in einem <fencedframe> angezeigt wird, erzeugt eine 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 Gewinneranzeige 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 in den runAdAuction()-Aufruf übergeben werden, um ein FencedFrameConfig-Objekt zu erhalten. Wenn dies nicht gesetzt ist, wird das resultierende Promise in einen URN aufgelöst, der nur in einem <iframe> verwendet werden kann.

Eingezäunte Frames auf privacysandbox.google.com
Die Privacy Sandbox auf privacysandbox.google.com

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Fenced Frame API
HTMLFencedFrameElement
Instanzeigenschaften
1. allow
2. config
3. height
4. width
Vererbung
Verwandte Seiten für Fenced Frame API
Anleitungen
1. Kommunikation mit eingebetteten Frames

HTMLFencedFrameElement: config-Eigenschaft

In diesem Artikel

Wert

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN