options_ui
| Typ | Object |
|---|---|
| Obligatorisch | Nein |
| Manifest-Version | 2 oder höher |
| Beispiel |
json |
Verwenden Sie den Schlüssel options_ui, um eine Optionsseite für Ihre Erweiterung zu definieren. Diese Seite ermöglicht es den Nutzern, die Einstellungen Ihrer Erweiterung zu ändern.
Die Art und Weise, wie der Benutzer die Seite öffnet, hängt vom Browser und der Einstellung open_in_tab ab. Ihre Erweiterung kann die Seite auch mit runtime.openOptionsPage() öffnen.
Sie geben options_ui als Pfad zu einer HTML-Datei an, die mit Ihrer Erweiterung gepackt ist. Die HTML-Datei kann CSS- und JavaScript-Dateien enthalten, genau wie eine normale Webseite. Im Gegensatz zu einer normalen Seite kann das JavaScript jedoch alle WebExtension-APIs verwenden, für die die Erweiterung Berechtigungen hat. Es wird jedoch in einem anderen Bereich als Ihre Hintergrundskripte ausgeführt.
Wenn Sie Daten oder Funktionen zwischen dem JavaScript auf Ihrer Optionsseite und Ihrem Hintergrund-Skript(e) teilen möchten, können Sie dies direkt tun, indem Sie eine Referenz auf das Window Ihrer Hintergrundskripte mit extension.getBackgroundPage() oder eine Referenz auf das Window einer beliebigen Seite, die innerhalb Ihrer Erweiterung ausgeführt wird, mit extension.getViews() erhalten. Alternativ können Sie zwischen dem JavaScript Ihrer Optionsseite und Ihrem Hintergrund-Skript(e) mit runtime.sendMessage(), runtime.onMessage oder runtime.connect() kommunizieren. Letztere (oder die runtime.Port Äquivalente) können auch verwendet werden, um Optionen zwischen Ihrem Hintergrund-Skript(e) und Ihrem Inhalts-Skript(e). zu teilen.
Im Allgemeinen sollten Sie Optionen, die auf Optionsseiten geändert werden, mit der storage API entweder in storage.sync (wenn Sie die Einstellungen über alle Instanzen dieses Browsers, bei denen der Benutzer angemeldet ist, synchronisieren möchten) oder storage.local (wenn die Einstellungen lokal auf dem aktuellen Gerät/Profil sein sollen). Wenn Sie dies tun und Ihr Hintergrund-Skript(e) (oder Inhalts-Skript(e)) über die Änderung informiert werden müssen, könnte Ihr Skript(e) entscheiden, einen Listener zu storage.onChanged hinzuzufügen.
Syntax
Der Schlüssel options_ui ist ein Objekt mit folgendem Inhalt:
| Name | Typ | Beschreibung |
|---|---|---|
browser_style
Optional Veraltet in Manifest V3. |
Boolean |
Optional, Standardwert:
Setzen Sie
In Firefox kann das Stylesheet unter
|
open_in_tabOptional |
Boolean |
Standardwert ist |
page |
String |
Obligatorisch. Der Pfad zu einer HTML-Datei, die die Spezifikation Ihrer Optionsseite enthält.
Der Pfad ist relativ zum Speicherort von
|
Beispiel
"options_ui": {
"page": "options/options.html"
}
Browser-Kompatibilität
Loading…
Siehe auch
options_pageVeraltet- Browser-Stile
- Optionsseiten