<fencedframe> HTML fenced frame-Element

Attribute

Dieses Element umfasst die globalen Attribute.

allow

Gibt eine Permissions Policy für das <fencedframe> an, die definiert, welche Funktionen dem <fencedframe> basierend auf dem Ursprung der Anfrage verfügbar sind. Siehe Verfügbare Berechtigungspolicies für fenced frames für weitere Details, welche Funktionen durch eine auf einem fenced frame gesetzte Policy gesteuert werden können.

height

Ein ganzzahliger Wert ohne Einheit, der die Höhe des fenced frames in CSS-Pixel angibt. Der Standardwert ist 150.

width

Ein ganzzahliger Wert ohne Einheit, der die Breite des fenced frames in CSS-Pixel angibt. Der Standardwert ist 300.

Verfügbare Berechtigungspolicies für fenced frames

Berechtigungen, die vom obersten Kontext an einen fenced frame delegiert werden, um Funktionen zu erlauben oder zu verweigern, könnten als Kommunikationskanal genutzt werden und stellen daher ein Datenschutzrisiko dar. Aus diesem Grund sind standardmäßige Web-Funktionen, deren Verfügbarkeit durch die Permissions Policy kontrolliert werden kann (zum Beispiel, camera oder geolocation), innerhalb von fenced frames nicht verfügbar.

Die einzigen Funktionen, die durch eine Policy innerhalb von fenced frames aktiviert werden können, sind die spezifischen Funktionen, die zur Nutzung 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 immer innerhalb von fenced frames aktiviert. In Zukunft wird es möglich sein, mithilfe des <fencedframe>-allow-Attributes zu kontrollieren, welche von ihnen aktiviert sind. Das Blockieren von Privacy Sandbox-Funktionen auf diese Weise wird auch das Laden des fenced frames blockieren — es wird keinen Kommunikationskanal geben.

Fokussieren über die Grenzen von fenced frames hinweg

Die Fähigkeit des aktiven Fokus des Dokuments, über die Grenzen von fenced frames hinweg verschoben zu werden (d.h. von einem Element außerhalb des fenced frames zu einem innerhalb, oder umgekehrt), ist eingeschränkt. Benutzerinitiierte Aktionen wie ein Klick oder ein Tab können dies tun, da hierbei kein Fingerprinting-Risiko besteht.

Jedoch ist der Versuch, die Grenze über einen API-Aufruf wie HTMLElement.focus() zu durchqueren, verboten — ein bösartiges Skript könnte eine Reihe solcher Aufrufe verwenden, um abgeleitete Informationen über die Grenze hinweg zu leaken.

Positionierung und Skalierung

Als ein 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 ändert das Ändern der width oder height des <fencedframe> die Größe des eingebetteten Containers auf der Seite, aber das Dokument innerhalb des Containers wird visuell skaliert, um zu passen. Die gemeldete Breite und Höhe des eingebetteten Dokuments (d.h. Window.innerWidth und Window.innerHeight) bleibt unverändert.

Barrierefreiheit

Personen, die mit assistiver Technologie navigieren, wie einem Bildschirmleser, können das title-Attribut auf einem <fencedframe> verwenden, um dessen Inhalt zu kennzeichnen. 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> hinein navigieren, um festzustellen, was sein eingebetteter Inhalt ist. Diese Kontextverschiebung kann verwirrend und zeitaufwendig sein, insbesondere bei Seiten mit mehreren <fencedframe>s und/oder wenn Embeds interaktive Inhalte wie Video oder Audio enthalten.

Beispiele

Um festzulegen, welcher Inhalt in einem <fencedframe> angezeigt wird, generiert 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 eine FencedFrameConfig aus einer Werbeauktion der Protected Audience API, die dann verwendet wird, um die gewonnene 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;

Technische Zusammenfassung

Spezifikationen

Browser-Kompatibilität

Siehe auch

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