pageAction.setPopup()

設定當用戶點選頁面操作圖示時要開啟的 HTML 文件作為彈出視窗。

語法

js
browser.pageAction.setPopup(
  details // object
)

引數

details

object.

tabId

integer。您想設定彈出視窗的選項卡的 ID。

stringnull。要顯示在彈出視窗中的 HTML 檔案的 URL。

如果此處傳遞的是空字串 (""),則彈出視窗將被停用,並且擴充套件程式將接收 pageAction.onClicked 事件。

如果此處傳遞的是 null,則彈出視窗將重置為在 page_action manifest 鍵中指定的彈出視窗。

示例

監聽 tabs.onUpdated 事件,並在載入狀態改變時切換彈出視窗。

js
browser.tabs.onUpdated.addListener((tabId, changeInfo, tabInfo) => {
  if (changeInfo.status) {
    browser.pageAction.show(tabId);
    if (changeInfo.status === "loading") {
      browser.pageAction.setPopup({
        tabId,
        popup: "/popup/loading.html",
      });
    } else {
      browser.pageAction.setPopup({
        tabId,
        popup: "/popup/complete.html",
      });
    }
  }
});

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.pageAction API。本文件源自 Chromium 程式碼中的 page_action.json