page_action

Typ	`Object`
Verpflichtend	Nein
Manifest-Version	2 oder höher
Beispiel	json `"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 ist ein Symbol, das Ihre Erweiterung in der URL-Leiste des Browsers hinzufügt.

Ihre Erweiterung kann optional auch ein zugehöriges Popup bereitstellen, dessen Inhalt mithilfe von HTML, CSS und JavaScript angegeben wird.

Sie müssen diesen Schlüssel angeben, um eine Page Action in Ihre Erweiterung aufzunehmen. Wenn angegeben, können Sie die Schaltfläche programmatisch mithilfe der pageAction API manipulieren.

Wenn Sie ein Popup bereitstellen, wird dieses geöffnet, wenn der Benutzer auf das Symbol klickt, und Ihr JavaScript, das im Popup ausgeführt wird, kann die Interaktion des Benutzers damit verarbeiten. Wenn Sie kein Popup bereitstellen, wird beim Klick des Benutzers auf das Symbol ein Klickereignis an die Hintergrundskripte Ihrer Erweiterung gesendet.

Page Actions ähneln Browser Actions, außer dass sie mit bestimmten Webseiten und nicht mit dem gesamten Browser verbunden sind. Wenn eine Aktion nur auf bestimmten Seiten relevant ist, sollten Sie eine Page Action verwenden und sie nur auf den relevanten Seiten anzeigen. Wenn eine Aktion für alle Seiten oder für den Browser selbst relevant ist, verwenden Sie eine Browser Action.

Während Browser Actions standardmäßig angezeigt werden, sind Page Actions standardmäßig ausgeblendet. Sie können für einen bestimmten Tab angezeigt werden, indem Sie pageAction.show() aufrufen und die id des Tabs übergeben. Sie können dieses Standardverhalten auch mit der Eigenschaft show_matches ändern.

Syntax

Der Schlüssel page_action ist ein Objekt, das bis zu drei Eigenschaften enthalten kann, alle optional:

Name	Typ	Beschreibung
`browser_style` Optional Veraltet in Manifest V3.	`Boolean`	Optional. Standardmäßig `false`. Setzen Sie `browser_style` nicht auf true: Es wird in Manifest V3 ab Firefox 118 nicht unterstützt. Siehe Manifest V3 Migration für `browser_style`. In Firefox kann das Stylesheet unter `chrome://browser/content/extension.css` oder `chrome://browser/content/extension-mac.css` auf macOS angesehen werden. Die latest-download Beispielerweiterung verwendet `browser_style` in ihrem Popup.
`default_icon`	`Object` oder `String`	Verwenden Sie dies, um ein Symbol für die Aktion anzugeben. Es wird empfohlen, hier zwei Symbole anzugeben (19×19 Pixel und 38×38 Pixel) und diese in einem Objekt mit den Eigenschaften `"19"` und `"38"` zu spezifizieren, wie folgt: json `"default_icon": { "19": "geo-19.png", "38": "geo-38.png" }` Wenn Sie dies tun, wählt der Browser die richtige Symbolgröße für die Pixeldichte des Bildschirms. Sie können hier auch einfach einen String angeben: json `"default_icon": "geo.png"` Wenn Sie dies tun, wird das Symbol skaliert, um in die Symbolleiste zu passen, und kann unscharf erscheinen.
`default_popup`	`String`	Der Pfad zu einer HTML-Datei, die die Spezifikation des Popups enthält. Die HTML-Datei kann CSS- und JavaScript-Dateien enthalten, die mit `<link>` und `<script>` -Elementen eingebunden werden, genau wie eine normale Webseite. Verwenden Sie jedoch nicht `<script>` mit eingebettetem Code, da Sie sonst einen Content Violation 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 ausgeführt wird, auf alle WebExtension-APIs zugreifen (natürlich vorausgesetzt, dass die Erweiterung über die entsprechenden Berechtigungen verfügt). Dies ist eine lokalisierbare Eigenschaft.
`default_title`	`String`	Tooltip für das Symbol, das angezeigt wird, wenn der Benutzer die Maus darüber bewegt. Dies ist eine lokalisierbare Eigenschaft.
`hide_matches`	`Array` von `Match Pattern` außer `<all_urls>`	Blendet die Page Action standardmäßig für Seiten aus, 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. Aus diesem Grund macht es nur Sinn, diese Eigenschaft aufzunehmen, wenn auch `show_matches` angegeben ist, und sie überschreibt die Muster in `show_matches`. Beispielsweise könnte ein Wert wie folgt aussehen: json `"page_action": { "show_matches": ["https://.mozilla.org/"], "hide_matches": ["https://newreal1.mobosoft.fun/*"] }` Dies zeigt die Page Action standardmäßig für alle HTTPS-URLs unter der Domain `"mozilla.org"` an, außer für Seiten unter `"newreal1.mobosoft.fun"`.
`show_matches`	`Array` von `Match Pattern`	Zeigt die Page Action standardmäßig für Seiten an, deren URLs mit einem der angegebenen Muster übereinstimmen. Siehe auch `hide_matches`.
`pinned` Veraltet	`Boolean`	Optional. Standardmäßig `true`. Kontrolliert, 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

json

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

Eine Page Action mit nur einem Symbol, das in 2 verschiedenen Größen angegeben ist. Die Hintergrundskripte der Erweiterung können Klickereignisse empfangen, wenn der Benutzer auf das Symbol klickt, indem Code wie folgt verwendet wird:

browser.pageAction.onClicked.addListener(handleClick);

json

"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 Symbol, einem Titel und einem Popup. Das Popup wird angezeigt, wenn der Benutzer auf das Symbol klickt.

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden