page_action

Syntax

Der Schlüssel page_action ist ein Objekt, das drei optionale Eigenschaften haben kann:

browser_style Optional

Boolean. Standardmäßig auf false gesetzt.

Warnung: Setzen Sie browser_style nicht auf wahr: Es wird in Manifest V3 nicht unterstützt, beginnend mit Firefox 118. Sehen Sie sich die Manifest V3-Migration für browser_style an.

In Firefox kann das Stylesheet unter chrome://browser/content/extension.css oder chrome://browser/content/extension-mac.css auf macOS eingesehen werden. Die latest-download Beispiel-Erweiterung verwendet browser_style in ihrem Popup.

default_icon Optional

Object oder String. Verwenden Sie dies, um ein Icon für die Aktion anzugeben.

Es wird empfohlen, hier zwei Icons bereitzustellen (19×19 Pixel und 38×38 Pixel) und sie in einem Objekt mit den Eigenschaften "19" und "38" anzugeben, wie hier:

json

"default_icon": {
  "19": "geo-19.png",
  "38": "geo-38.png"
}

Wenn Sie dies tun, wird der Browser die passende Icon-Größe für die Pixel-Dichte des Bildschirms auswählen.

Sie können hier auch einfach einen String angeben:

json

"default_icon": "geo.png"

Wenn Sie dies tun, wird das Icon auf die Symbolleiste skaliert und kann unscharf erscheinen.

Sie können ein SVG-Icon verwenden. Sie können das Icon auch an helle und dunkle Themen anpassen, indem Sie eine Medienabfrage zu prefers-color-scheme verwenden. Zum Beispiel:

css

#outside {
  fill: black;
}
#inside {
  fill: red;
}
@media (prefers-color-scheme: dark) {
  #outside {
    fill: white;
  }
  #inside {
    fill: black;
  }
}

Für weitere Informationen siehe das themed-icons Beispiel.

Hinweis: Ein impliziter CSS-Filter wird auf SVG-Icons in dunklen UI-Themen angewendet. Dieser Filter wird in der Firefox-Desktop-Version 152 deaktiviert (Firefox-Bug 2016509). Sie können SVG-Icons mit deaktiviertem CSS-Filter testen, indem Sie eine boolesche about:config-Präferenz mit dem Namen extensions.webextensions.pageActionIconDarkModeFilter.enabled erstellen und auf false setzen. Der Filter ist standardmäßig in Firefox Desktop Nightly ab 149 deaktiviert.

default_popup Optional

String. Der Pfad zu einer HTML-Datei, die die Spezifikation des Popups enthält. Die HTML-Datei kann CSS- und JavaScript-Dateien mit <link> und <script>-Elementen einbinden, ähnlich wie eine normale Webseite.

Verwenden Sie jedoch kein <script> mit eingebettetem Code, da Sie sonst einen Content Security Policy-Fehler erhalten. Stattdessen muss <script> das src-Attribut verwenden, um eine separate Skriptdatei zu laden.

Im Gegensatz zu einer normalen Webseite kann JavaScript, das im Popup läuft, auf alle WebExtension-APIs zugreifen (sofern die Erweiterung die entsprechenden Berechtigungen hat). Dies ist eine lokalisierbare Eigenschaft.

default_title Optional

String. Tooltip für das Icon, das angezeigt wird, wenn der Benutzer die Maus darüber bewegt. Dies ist eine lokalisierbare Eigenschaft.

hide_matches Optional

Array von MatchPattern außer <all_urls>. Versteckt die Page Action standardmäßig für Seiten, deren URLs mit einem der angegebenen Match Patterns übereinstimmen.

Beachten Sie, dass Page Actions standardmäßig immer ausgeblendet sind, es sei denn, show_matches ist angegeben. Daher macht es nur Sinn, diese Eigenschaft einzuschließen, wenn show_matches ebenfalls angegeben ist und wird die Muster in show_matches überschreiben.

Betrachten Sie zum Beispiel einen Wert wie:

json

"page_action": {
  "show_matches": ["https://*.mozilla.org/*"],
  "hide_matches": ["https://developer.mozilla.org/*"]
}

Dies zeigt die Page Action standardmäßig für alle HTTPS-URLs unter der Domain "mozilla.org" an, außer für Seiten unter "developer.mozilla.org".

show_matches Optional

Array von MatchPattern. Zeigt die Page Action standardmäßig für Seiten an, deren URLs mit einem der angegebenen Muster übereinstimmen. Siehe auch hide_matches.

pinned Optional

Boolean. Optional. Standardmäßig auf true gesetzt. Steuert, ob die Page Action standardmäßig in der Adressleiste angezeigt werden soll, wenn der Benutzer die Erweiterung installiert. Diese Eigenschaft wird seit Firefox 89 nicht mehr unterstützt.

Beispiel

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

Eine Page Action mit nur einem Icon, angegeben in 2 verschiedenen Größen. Die Hintergrundskripte der Erweiterung können Klick-Ereignisse empfangen, wenn der Benutzer auf das Icon klickt, mit einem Code wie diesem:

browser.pageAction.onClicked.addListener(handleClick);

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

Eine Page Action mit einem Icon, einem Titel und einem Popup. Das Popup wird angezeigt, wenn der Benutzer auf das Icon klickt.

Browser-Kompatibilität

Siehe auch

• browser_action
• sidebar_action
• Browser-Stile