HTMLIFrameElement: browsingTopics-Eigenschaft
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Warnung: Dieses Feature wird momentan von zwei Browser-Anbietern abgelehnt. Einzelheiten zur Ablehnung finden Sie im Abschnitt Standards positions.
Die browsingTopics-Eigenschaft des HTMLIFrameElement-Interfaces ist ein boolescher Wert, der angibt, dass die ausgewählten Themen des aktuellen Benutzers mit der Anfrage für die zugeordnete Quelle des <iframe> im Sec-Browsing-Topics-Header gesendet werden sollen. Dies spiegelt das browsingtopics-HTML-Attribut wider.
Weitere Informationen finden Sie unter Using the Topics API.
Wert
Ein boolescher Wert. Der Standardwert ist false; setzen Sie ihn auf true, um die Anfrage für die zugeordnete <iframe>-Quelle mit einem Sec-Browsing-Topics-Header zu senden, der die ausgewählten Themen für den aktuellen Benutzer enthält.
Beispiele
Abfragen
Setzen Sie browsingtopics auf true, und laden Sie dann den Inhalt des <iframe> deklarativ:
<iframe browsingtopics title="Advertising container" src="ad-tech1.example">
...
</iframe>
Protokollieren Sie den browsingTopics-Wert über ein Skript:
const iframeElem = document.querySelector("iframe");
console.log(iframeElem.browsingTopics); // will return true in supporting browsers
Setzen
Definieren Sie ein minimales <iframe>:
<iframe> ... </iframe>
Setzen Sie browsingtopics auf true, und laden Sie dann den Inhalt des <iframe> über ein Skript:
const iframeElem = document.querySelector("iframe");
iframeElem.browsingTopics = true;
iframeElem.title = "Advertising container";
iframeElem.src = "ad-tech1.example";
Spezifikationen
Dieses Feature ist kein Teil eines offiziellen Standards, obwohl es im Topics API Unofficial Proposal Draft spezifiziert ist.