<fencedframe>: Das Fenced Frame-Element

Dieses Element beinhaltet die globalen Attribute.

allow Experimentell

Gibt eine Rechtepolitik für das <fencedframe> an, die definiert, welche Funktionen dem <fencedframe> basierend auf dem Ursprung der Anfrage zur Verfügung stehen. Details darüber, welche Funktionen über eine auf einem Fenced Frame gesetzte Politik kontrolliert werden können, finden Sie unter Rechtepolitiken, die für Fenced Frames verfügbar sind.

height Experimentell

Eine ganze Zahl ohne Einheit, die die Höhe des Fenced Frame in CSS-Pixeln darstellt. Der Standardwert ist 150.

width Experimentell

Eine ganze Zahl ohne Einheit, die die Breite des Fenced Frame in CSS-Pixeln darstellt. Der Standardwert ist 300.

Die von einem Kontext auf oberster Ebene an ein Fenced Frame delegierten Berechtigungen zum Zulassen oder Verweigern von Funktionen könnten als Kommunikationskanal genutzt werden und stellen somit eine Bedrohung für die Privatsphäre dar. Daher sind Standard-Web-Funktionen, die über eine Rechtepolitik in ihrer Verfügbarkeit kontrolliert werden können (zum Beispiel camera oder geolocation), innerhalb von Fenced Frames nicht verfügbar.

Die einzigen Funktionen, die durch eine Politik innerhalb von Fenced Frames aktiviert werden können, sind die spezifischen Funktionen, die für die Verwendung innerhalb von Fenced Frames entwickelt wurden:

• Protected Audience API
  • attribution-reporting
  • private-aggregation
  • shared-storage
  • shared-storage-select-url
• Shared Storage API
  • attribution-reporting
  • private-aggregation
  • shared-storage
  • shared-storage-select-url

Derzeit sind diese Funktionen immer innerhalb von Fenced Frames aktiviert. In der Zukunft wird es möglich sein, welche aktiviert sind, mithilfe des allow-Attributs des <fencedframe> zu kontrollieren. Das Blockieren von Privacy-Sandbox-Funktionen auf diese Weise wird auch das Laden des Fenced Frame blockieren — es wird keinen Kommunikationskanal geben.

Die Fähigkeit des aktiven Fokus eines Dokuments, über Fenced Frame-Grenzen hinweg zu wechseln (d.h. von einem Element außerhalb des Fenced Frame zu einem innerhalb oder umgekehrt), ist eingeschränkt. Benutzerinitiierte Aktionen wie ein Klick oder ein Tab können dies tun, da es dort kein Risiko des Fingerprintings gibt.

Versuche, die Grenze über einen API-Aufruf wie HTMLElement.focus() zu überwinden, sind jedoch verboten — ein bösartiges Skript könnte eine Reihe solcher Aufrufe verwenden, um erschlossene Informationen über die Grenze zu leaken.

Als ersetztes Element erlaubt das <fencedframe>, die Position des eingebetteten Dokuments innerhalb seines Rahmens mithilfe der object-position-Eigenschaft zu justieren.

Die Größe des eingebetteten Inhalts kann durch die internen contentWidth- und contentHeight-Eigenschaften des config-Objekts des <fencedframe> festgelegt werden. In solchen Fällen ändert das Ändern der width oder height des <fencedframe> die Größe des auf der Seite eingebetteten Containers, aber das Dokument innerhalb des Containers wird optisch skaliert, um zu passen. Die gemeldete Breite und Höhe des eingebetteten Dokuments (d.h. Window.innerWidth und Window.innerHeight) bleibt unverändert.

Menschen, die mit assistiver Technologie navigieren, wie einem Bildschirmlesegerät, können das title-Attribut auf einem <fencedframe> verwenden, um dessen Inhalt zu beschriften. Der Wert des Titels sollte den eingebetteten Inhalt prägnant beschreiben:

<fencedframe
  title="Advertisement for new Log. From Blammo!"
  width="640"
  height="320"></fencedframe>

Ohne diesen Titel müssen sie in das <fencedframe> navigieren, um dessen eingebetteten Inhalt zu bestimmen. Dieser Kontextwechsel kann verwirrend und zeitaufwändig sein, insbesondere für Seiten mit mehreren <fencedframe>s und/oder wenn Einbettungen interaktive Inhalte wie Video oder Audio enthalten.

Um festzulegen, welche Inhalte in einem <fencedframe> angezeigt werden, generiert eine verwendende 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 von einer Anzeigenauktion der Protected Audience API, welches anschließend verwendet wird, um die gewonnene Anzeige in einem <fencedframe> anzuzeigen:

<fencedframe width="640" height="320"></fencedframe>

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

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

• Fenced Frame API
• Fenced frames auf developers.google.com
• The Privacy Sandbox auf developers.google.com