pageAction.setPopup()

将要打开的 HTML 文档设置为弹出窗口，用户点击页面操作图标时打开。

语法

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

参数

details

对象.

tabId

整数。要为其设置弹出窗口的选项卡的 ID。

字符串 或 null。显示在弹出窗口中的 HTML 文件的 URL。

如果此处传递空字符串 ("")，则禁用弹出窗口，并且扩展程序将接收 pageAction.onClicked 事件。

如果此处传递 null，则弹出窗口将重置为在 page_action 清单键中指定的弹出窗口。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

侦听 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。