pageAction.setPopup()

Setzt das HTML-Dokument, das als Popup geöffnet werden soll, wenn der Benutzer auf das Symbol der Seitenaktion klickt.

Syntax

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

Parameter

details

object.

tabId

integer. Die ID des Tabs, für den Sie das Popup festlegen möchten.

string oder null. URL zur HTML-Datei, die im Popup angezeigt werden soll.

Wenn hier ein leerer String ("") übergeben wird, wird das Popup deaktiviert und die Erweiterung erhält pageAction.onClicked-Ereignisse.

Wenn hier null übergeben wird, wird das Popup auf das Popup zurückgesetzt, das im page_action Manifest-Schlüssel angegeben wurde.

Browser-Kompatibilität

Beispiele

Hören Sie auf tabs.onUpdated-Ereignisse und wechseln Sie das Popup, wenn sich der Ladezustand ändert:

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",
      });
    }
  }
});

Hinweis: Diese API basiert auf der Chromium-API chrome.pageAction. Diese Dokumentation leitet sich ab von page_action.json im Chromium-Code.