theme
| Typ | Object |
|---|---|
| Obligatorisch | Nein |
| Manifest-Version | 2 oder höher |
| Beispiel |
json |
Verwenden Sie den theme-Schlüssel, um ein statisches Theme zu definieren, das auf Firefox angewendet wird. Wenn der Schlüssel allein bereitgestellt wird, definiert dies das Theme, das verwendet wird, wenn Firefox entweder die helle oder die dunkle Farbgebung verwendet. Wenn der dark_theme-Schlüssel bereitgestellt wird, stellt dieser Schlüssel das Theme bereit, das verwendet wird, wenn Firefox die helle Farbgebung verwendet.
Hinweis:
Wenn Sie ein Theme mit einer Erweiterung einbeziehen möchten, lesen Sie die theme API.
Hinweis: Seit Mai 2019 müssen Themes signiert sein, um installiert zu werden (Firefox-Fehler 1545109). Weitere Informationen finden Sie unter Signieren und Verteilen Ihres Add-ons.
Hinweis: Eine neue Version von Firefox für Android, basierend auf GeckoView, befindet sich in der Entwicklung. Eine Vorabversion ist verfügbar. Die Vorabversion unterstützt keine Themes.
Bildformate
Die folgenden Bildformate werden in allen Theme-Bild-Eigenschaften unterstützt:
- JPEG
- PNG
- APNG
- SVG (animiertes SVG wird ab Firefox 59 unterstützt)
- GIF (animiertes GIF wird nicht unterstützt)
Syntax
Der theme-Schlüssel ist ein Objekt, das die folgenden Eigenschaften hat:
| Name | Typ | Beschreibung |
|---|---|---|
images |
Object |
Seit Firefox 60 optional. Vor Firefox 60 obligatorisch.
Ein JSON-Objekt, dessen Eigenschaften die Bilder darstellen, die in
verschiedenen Teilen des Browsers angezeigt werden. Siehe
|
colors |
Object |
Obligatorisch.
Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener Teile
des Browsers darstellen. Siehe |
properties |
Object |
Optional
Dieses Objekt enthält Eigenschaften, die beeinflussen, wie die
|
images
Alle URLs sind relativ zur manifest.json-Datei und können keine externe URL referenzieren.
Bilder sollten 200 Pixel hoch sein, um sicherzustellen, dass sie immer den Header-Bereich vertikal ausfüllen.
| Name | Typ | Beschreibung |
|---|---|---|
theme_frame |
String |
Die URL eines Vordergrundbildes, das dem Headerbereich hinzugefügt und an der oberen rechten Ecke des Headerbereichs verankert wird. Hinweis: Chrome verankert das Bild an der oberen linken Ecke des Headers und wenn das Bild den Headerbereich nicht ausfüllt, wird das Bild gekachelt. Seit Firefox 60 auf Desktop optional. Erforderlich in Firefox für Android. |
additional_backgrounds |
Array von String |
Warnung: Die
Ein Array von URLs für zusätzliche Hintergrundbilder, die dem
Headerbereich hinzugefügt und hinter dem
Optional.
Standardmäßig sind alle Bilder an der oberen rechten Ecke des
Headerbereichs verankert, aber ihre Ausrichtung und Wiederholungs-
verhalten können durch Eigenschaften von |
colors
Diese Eigenschaften definieren die Farben für verschiedene Teile des Browsers. Sie sind alle optional. Wie diese Eigenschaften die Firefox-Benutzeroberfläche beeinflussen, wird hier gezeigt:
|
|
Hinweis: Wenn ein Element von mehreren Farbeigenschaften beeinflusst wird, sind die Eigenschaften in der Reihenfolge der Priorität aufgelistet.
Alle diese Eigenschaften können entweder als String angegeben werden, der einen gültigen CSS-Farbstring (einschließlich Hexadezimal) enthält, oder als RGB-Array, wie "tab_background_text": [ 107 , 99 , 23 ].
Hinweis: In Chrome können Farben nur als RGB-Arrays angegeben werden.
In Firefox für Android können Farben angegeben werden mittels:
- Voller Hexadezimal-Notation, d.h. nur #RRGGBB. alpha und verkürzte Syntax, wie in #RGB[A], werden nicht unterstützt.
- Funktionale Notation (RGB-Arrays) für Themen, die mindestens Firefox 68.2 anvisieren.
Farben für Firefox für Android-Themen können nicht mit Farbnamen angegeben werden.
| Name | Beschreibung |
|---|---|
bookmark_text |
Die Farbe von Texten und Icons in den Lesezeichen- und Suchleisten. Auch,
wenn
Hinweis: Stellen Sie sicher, dass jede verwendete Farbe gut zu
den in
Wo Siehe Beispieljson
|
button_background_active |
Die Hintergrundfarbe der gedrückten Symbolleistenschaltflächen. Siehe Beispieljson
|
button_background_hover |
Die Hintergrundfarbe der Symbolleistenschaltflächen beim Hover. Siehe Beispieljson
|
icons |
Die Farbe der Symbolleisten-Icons, mit Ausnahme derjenigen in der Suchleiste.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
den in Siehe Beispieljson
|
icons_attention |
Die Farbe der Symbolleisten-Icons im Aufmerksamkeitszustand wie das markierte Lesezeichen-Icon oder das Icon für beendete Downloads.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
den in Siehe Beispieljson
|
frame |
Die Farbe des Hintergrundes im Headerbereich, die im Teil des
Headers angezeigt wird, der nicht durch die in
Siehe Beispieljson
|
frame_inactive |
Die Farbe des Hintergrunds im Headerbereich, wenn das Browserfenster
inaktiv ist, angezeigt im Teil des Headers, der nicht durch
die in Siehe Beispieljson
|
ntp_background |
Die Hintergrundfarbe der neuen Tab-Seite. Siehe Beispieljson
|
ntp_card_background |
Die Hintergrundfarbe der Karten auf der neuen Tab-Seite. Siehe Beispieljson
|
ntp_text |
Die Textfarbe auf der neuen Tab-Seite.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
den in Siehe Beispieljson
|
popup |
Die Hintergrundfarbe von Popups (wie dem Dropdown der URL-Leiste und den Pfeil-Panels). Siehe Beispieljson
|
popup_border |
Die Umrandungsfarbe von Popups. Siehe Beispieljson
|
popup_highlight |
Die Hintergrundfarbe von hervorgehobenen Elementen, die mithilfe der Tastatur innerhalb von Popups (wie dem ausgewählten URL-Leisten-Dropdown-Element) ausgewählt werden.
Hinweis: Es wird empfohlen, Siehe Beispieljson
|
popup_highlight_text |
Die Textfarbe von hervorgehobenen Elementen innerhalb von Popups.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
popup_text |
Die Textfarbe von Popups.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
sidebar |
Die Hintergrundfarbe der Seitenleiste. Siehe Beispieljson
|
sidebar_border |
Die Rand- und Trennerfarbe der Browser-Seitenleiste Siehe Beispieljson
|
sidebar_highlight |
Die Hintergrundfarbe von hervorgehobenen Zeilen in eingebauten Sidebars Siehe Beispieljson
|
sidebar_highlight_text |
Die Textfarbe von hervorgehobenen Zeilen in Sidebars.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
sidebar_text |
Die Textfarbe der Sidebars.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
tab_background_separator
|
Warnung: Die Farbe des vertikalen Trenner der Hintergrund-Tabs. Siehe Beispieljson
|
tab_background_text |
Die Farbe des Textes, der in den inaktiven Seitentabs angezeigt wird.
Wenn
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
den in Siehe Beispieljson
|
tab_line |
Die Farbe des ausgewählten Tab-Linie. Siehe Beispieljson
|
tab_loading |
Die Farbe des Ladeindikators und des Ladebursts des Tabs. Siehe Beispieljson
|
tab_selected |
Die Hintergrundfarbe des ausgewählten Tabs. Wenn nicht verwendet, wird die ausgewählte
Tab-Farbe durch Siehe Beispieljson
|
tab_text |
Ab Firefox 59 repräsentiert es die Textfarbe für den ausgewählten Tab. Wenn
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
den in Siehe Beispieljson
|
toolbar |
Die Hintergrundfarbe für die Navigationsleiste, die Lesezeichenleiste und den ausgewählten Tab. Dies stellt auch die Hintergrundfarbe der "Suchen"-Leiste ein. Siehe Beispieljson
|
toolbar_bottom_separator |
Die Farbe der Linie, die den unteren Rand der Symbolleiste vom darunter liegenden Bereich trennt. Siehe Beispieljson
|
toolbar_field |
Die Hintergrundfarbe für Felder in der Symbolleiste, wie die URL-Leiste. Dies setzt auch die Hintergrundfarbe des Such-in-der-Seite Feldes. Siehe Beispieljson
|
toolbar_field_border |
Die Umrandungsfarbe für Felder in der Symbolleiste. Dies setzt auch die Rahmenfarbe des Such-in-der-Seite Feldes. Siehe Beispieljson
|
toolbar_field_border_focus |
Die fokussierte Umrandungsfarbe für Felder in der Symbolleiste. Siehe Beispieljson
|
toolbar_field_focus |
Die fokussierte Hintergrundfarbe für Felder in der Symbolleiste, wie die URL-Leiste. Siehe Beispieljson
|
toolbar_field_highlight |
Die Hintergrundfarbe zur Anzeige der aktuellen Auswahl von Text in der
URL-Leiste (und der Suchleiste, falls konfiguriert, um separat zu sein).
Siehe Beispieljson
Hier spezifiziert das |
toolbar_field_highlight_text |
Die Farbe, die verwendet wird, um Text zu zeichnen, der derzeit in der URL-Leiste (und der Suchleiste, falls konfiguriert, um separat zu sein) ausgewählt ist.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
Hier wird das |
toolbar_field_separator |
Warnung:
Die Farbe der Trenner in der URL-Leiste. In Firefox 58 wurde dies
als Siehe Beispieljson
In diesem Screenshot ist |
toolbar_field_text |
Die Farbe des Textes in Feldern in der Symbolleiste, wie der URL-Leiste. Dies setzt auch die Farbe des Textes im Such-in-der-Seite Feld.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
toolbar_field_text_focus |
Die Farbe des Textes in fokussierten Feldern in der Symbolleiste, wie der URL-Leiste.
Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu
der in Siehe Beispieljson
|
toolbar_text |
Die Farbe des Symbolleisten-Textes. Diese setzt auch die Farbe des Textes in der "Suchen"-Leiste.
Hinweis: Für die Kompatibilität mit Chrome verwenden Sie den Alias
Siehe Beispieljson
|
toolbar_top_separator |
Die Farbe der Linie, die den oberen Rand der Symbolleiste von dem darüber liegenden Bereich trennt. Siehe Beispieljson
|
toolbar_vertical_separator |
Die Farbe des Trenners in der Lesezeichen-Symbolleiste. In Firefox 58 entspricht sie der Farbe der Trennstriche in der URL-Leiste. Siehe Beispieljson
|
Aliase
Zusätzlich akzeptiert dieser Schlüssel verschiedene Eigenschaften, die Aliase für eine der oben genannten Eigenschaften sind. Diese werden zur Kompatibilität mit Chrome bereitgestellt. Wenn ein Alias gegeben ist und die Version ohne Alias ebenfalls gegeben ist, wird der Wert aus der Version ohne Alias übernommen.
| Name | Alias für |
|---|---|
bookmark_text |
toolbar_text |
properties
| Name | Typ | Beschreibung |
|---|---|---|
additional_backgrounds_alignment |
|
Optional
Ein Array von Enumerationswerten, das die Ausrichtung des
entsprechenden
Wenn nicht angegeben, ist der Standardwert |
additional_backgrounds_tiling |
|
Optional
Ein Array von Enumerationswerten, das definiert, wie das
entsprechende
Wenn nicht angegeben, ist der Standardwert |
color_scheme |
|
Optional Bestimmt, welches Farbschema auf das Chrome (zum Beispiel Kontextmenüs) und den Inhalt (zum Beispiel eingebaute Seiten und das bevorzugte Farbschema für Webseiten) angewendet wird. Optionen umfassen:
Wenn nicht angegeben, ist der Standardwert |
content_color_scheme |
|
Optional
Bestimmt, welches Farbschema auf den Inhalt angewendet wird (zum Beispiel eingebaute Seiten und
das bevorzugte Farbschema für Webseiten). Überschreibt
Wenn nicht angegeben, ist der Standardwert |
Beispiele
Ein grundlegendes Theme muss ein Bild definieren, das dem Header hinzugefügt wird, die Akzentfarbe, die im Header verwendet werden soll, und die Farbe des im Header verwendeten Textes:
"theme": {
"images": {
"theme_frame": "images/sun.jpg"
},
"colors": {
"frame": "#CF723F",
"tab_background_text": "black"
}
}
Mehrere Bilder können verwendet werden, um den Header zu füllen. Vor Firefox Version 60 verwenden Sie ein leeres oder transparentes Header-Bild, um die Platzierung jedes zusätzlichen Bildes zu steuern:
"theme": {
"images": {
"additional_backgrounds": [ "images/left.png", "images/middle.png", "images/right.png"]
},
"properties": {
"additional_backgrounds_alignment": [ "left top", "top", "right top"]
},
"colors": {
"frame": "blue",
"tab_background_text": "white"
}
}
Sie können den Header auch mit einem wiederholten Bild oder Bildern füllen, in diesem Fall ein einzelnes Bild, das in der Mitte oben im Header verankert und über den Rest des Headers wiederholt wird:
"theme": {
"images": {
"additional_backgrounds": [ "images/logo.png"]
},
"properties": {
"additional_backgrounds_alignment": [ "top" ],
"additional_backgrounds_tiling": [ "repeat" ]
},
"colors": {
"frame": "green",
"tab_background_text": "black"
}
}
Das folgende Beispiel verwendet die meisten der verschiedenen Werte für theme.colors:
"theme": {
"images": {
"theme_frame": "weta.png"
},
"colors": {
"frame": "darkgreen",
"tab_background_text": "white",
"toolbar": "blue",
"bookmark_text": "cyan",
"toolbar_field": "orange",
"toolbar_field_border": "white",
"toolbar_field_text": "green",
"toolbar_top_separator": "red",
"toolbar_bottom_separator": "white",
"toolbar_vertical_separator": "white"
}
}
Es gibt Ihnen einen Browser, der so aussieht:

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der URL-Leiste, die das Reader-Modus-Icon von den anderen Icons trennt.
Browser-Kompatibilität
Chrome-Kompatibilität
In Chrome:
-
colors/toolbar_textwird nicht verwendet, verwenden Sie stattdessencolors/bookmark_text. -
images/theme_frameverankert das Bild links oben im Header; wenn das Bild den Headerbereich nicht ausfüllt, wird das Bild gekachelt. -
Alle Farben müssen als ein Array von RGB-Werten angegeben werden, wie folgt:
json"theme": { "colors": { "frame": [255, 0, 0], "tab_background_text": [0, 255, 0], "bookmark_text": [0, 0, 255] } }Ab Firefox 59 können beide Formen, das Array-Format und das CSS-Farbformat, für alle Eigenschaften verwendet werden. Davor erforderten
colors/frameundcolors/tab_background_textdas Array-Format, während andere Eigenschaften das CSS-Farbformat erforderten.































