<fencedframe>: Das Fenced Frame-Element

Dieses Element enthält die globalen Attribute.

allow Experimentell

Gibt eine Zugangssicherheitsrichtlinie für das <fencedframe> an, die definiert, welche Funktionen dem <fencedframe> basierend auf dem Ursprung der Anfrage zur Verfügung stehen. Weitere Details, welche Funktionen über eine auf einem fenced frame gesetzte Richtlinie gesteuert werden können, finden Sie unter Zugangssicherheitsrichtlinien, die auf fenced frames verfügbar sind.

height Experimentell

Eine ganzzahlige Einheit, die die Höhe des fenced frames in CSS-Pixeln darstellt. Der Standardwert ist 150.

width Experimentell

Eine ganzzahlige Einheit, die die Breite des fenced frames in CSS-Pixeln darstellt. Der Standardwert ist 300.

Berechtigungen, die vom obersten Kontext an ein fenced frame delegiert werden, um Funktionen zu erlauben oder zu verweigern, könnten als Kommunikationskanal genutzt werden, was ein Datenschutzrisiko darstellt. Daher sind Standard-Webfunktionen, deren Verfügbarkeit über Zugangssicherheitsrichtlinien gesteuert werden kann (zum Beispiel, camera oder geolocation), nicht verfügbar innerhalb von fenced frames.

Die einzigen Funktionen, die von einer Richtlinie innerhalb von fenced frames aktiviert werden können, sind die spezifischen Funktionen, die zur Verwendung innerhalb von fenced frames gedacht sind:

• 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 Funktionen aktiviert sind, über das allow-Attribut des <fencedframe> zu steuern. Das Blockieren von Privacy Sandbox-Funktionen auf diese Weise verhindert auch das Laden des fenced frames — es wird überhaupt keinen Kommunikationskanal geben.

Die Möglichkeit, den aktiven Fokus eines Dokuments über fenced frame-Grenzen hinweg zu verschieben (d. h. von einem Element außerhalb des fenced frames zu einem innerhalb oder umgekehrt), ist begrenzt. Benutzerinitiierte Aktionen, wie etwa ein Klick oder ein Tab, können dies tun, da dort kein Risiko des Fingerprintings besteht.

Allerdings ist es untersagt, die Grenze über einen API-Aufruf wie HTMLElement.focus() zu durchbrechen — ein bösartiges Skript könnte eine Reihe solcher Aufrufe verwenden, um abgeleitete Informationen über die Grenze hinweg zu leaken.

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

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

Menschen, die mit unterstützender Technologie wie einem Screenreader navigieren, 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 zu bestimmen, was der eingebettete Inhalt ist. Dieser Kontextwechsel kann verwirrend und zeitaufwendig sein, insbesondere für Seiten mit mehreren <fencedframe>-Elementen und/oder falls Einbettungen interaktive Inhalte wie Video oder Audio enthalten.

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.

Das folgende Beispiel erhält eine FencedFrameConfig aus einer Anzeigenauktion der Protected Audience API, die dann verwendet wird, um die gewinnende Werbung 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