Allgemein alspage action Schaltfläche bezeichnet, ist diese Benutzeroberflächenoption eine Schaltfläche, die zur Browser-Adressleiste hinzugefügt wird. Benutzer klicken auf die Schaltfläche, um mit Erweiterungen zu interagieren.

Page actions und browser actions

Die Schaltfläche in der Adressleiste (oder page action) ist ähnlich der Toolbar-Schaltfläche (oder browser action).

Die Unterschiede sind:

• Der Ort der Schaltfläche:

  • Die page action wird innerhalb der Adressleiste des Browsers angezeigt.
  • Die browser action wird außerhalb der Adressleiste, in der Symbolleiste des Browsers, angezeigt.

• Die Sichtbarkeit der Schaltfläche:

  • Die page action ist standardmäßig verborgen (obwohl dieses Standardverhalten über dieshow_matches undhide_matchesManifest-Schlüsseln geändert werden kann), und Sie rufenpageAction.show() undpageAction.hide() auf, um sie in bestimmten Tabs anzuzeigen oder zu verbergen.
  • Die browser action wird immer angezeigt.

Verwenden Sie eine page action, wenn die Aktion in Bezug zur aktuellen Seite steht. Verwenden Sie eine browser action, wenn die Aktion sich auf den gesamten Browser oder auf viele Seiten bezieht. Zum Beispiel:

Die page action spezifizieren

Sie definieren die Eigenschaften der page action mit dempage_action Schlüssel in manifest.json:

"page_action": {  "default_icon": {    "19": "button/geo-19.png",    "38": "button/geo-38.png"  },  "default_title": "Whereami?"}

Der einzige obligatorische Schlüssel istdefault_icon.

Es gibt zwei Möglichkeiten, eine page action zu spezifizieren: mit oder ohne einPopup.

• Ohne ein Popup: Wenn der Benutzer auf die Schaltfläche klickt, wird ein Ereignis an die Erweiterung gesendet, welches die Erweiterung mitpageAction.onClicked abfängt:

  js

  browser.pageAction.onClicked.addListener(handleClick);

• Mit einem Popup: Dasclick Ereignis wird nicht gesendet. Stattdessen erscheint das Popup, wenn der Benutzer auf die Schaltfläche klickt. Der Benutzer interagiert anschließend mit dem Popup. Wenn der Benutzer außerhalb des Popups klickt, wird es automatisch geschlossen. Lesen Sie denPopup Artikel für weitere Details zur Erstellung und Verwaltung von Popups.

Beachten Sie, dass Ihre Erweiterung nur eine page action haben kann.

Sie können alle Eigenschaften der page action programmatisch mit derpageAction API ändern.

Symbole

Für Informationen zur Erstellung von Symbolen, die Sie mit Ihrer page action verwenden können, lesen SieIconography in derAcorn Design System Dokumentation.

Beispiele

Daswebextensions-examples Repository auf GitHub enthält daschill-out Beispiel, das eine page action ohne ein Popup implementiert.