pageAction.setPopup()

Legt das HTML-Dokument fest, das als Popup angezeigt wird, wenn der Benutzer auf das Symbol der Seitenauswahl 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 in einem Popup angezeigt werden soll.

Wenn hier eine leere Zeichenkette ("") übergeben wird, wird das Popup deaktiviert und die Erweiterung empfängt pageAction.onClicked-Ereignisse.

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

Browser-Kompatibilität

BCD tables only load in the browser

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 chrome.pageAction-API von Chromium. Diese Dokumentation ist abgeleitet von page_action.json im Chromium-Code.