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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
setPopup
The popup property of the details parameter can be set to null.

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

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.