HTMLIFrameElement:browsingTopics 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

警告:此功能目前受到兩家瀏覽器廠商的反對。有關反對的詳細資訊,請參閱標準立場部分。

HTMLIFrameElement 介面的 browsingTopics 屬性是一個布林值,用於指定當前使用者的精選主題應在與 <iframe> 關聯的資源的請求中,透過 Sec-Browsing-Topics 標頭髮送。這反映了 browsingtopics HTML 屬性。

有關更多詳細資訊,請參閱使用 Topics API

一個布林值。預設值為 false;將其設定為 true,以便在請求關聯的 <iframe> 資源時,包含一個包含當前使用者精選主題的 Sec-Browsing-Topics 標頭。

示例

獲取

browsingtopics 設定為 true,然後宣告式載入 <iframe> 內容

html
<iframe browsingtopics title="Advertising container" src="ad-tech1.example">
  ...
</iframe>

透過指令碼記錄 browsingTopics 的值

js
const iframeElem = document.querySelector("iframe");
console.log(iframeElem.browsingTopics); // will return true in supporting browsers

Set

指定一個最小的 <iframe>

html
<iframe> ... </iframe>

browsingtopics 設定為 true,然後透過指令碼載入 <iframe> 內容

js
const iframeElem = document.querySelector("iframe");

iframeElem.browsingTopics = true;
iframeElem.title = "Advertising container";
iframeElem.src = "ad-tech1.example";

規範

此功能不是官方標準的一部分,儘管它在Topics API 非官方提案草案中有所說明。

瀏覽器相容性

另見