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