theme
| Typ | Object |
|---|---|
| Erforderlich | Nein |
| Manifest-Version | 2 oder höher |
| Beispiel |
json |
Verwenden Sie den Schlüssel theme, um ein statisches Theme für Firefox zu definieren. Wenn nur dieser Schlüssel angegeben wird, definiert er das Theme, das Firefox sowohl beim hellen als auch beim dunklen Farbschema verwendet. Wenn der Schlüssel dark_theme angegeben ist, definiert theme das Theme für das helle Farbschema.
Hinweis:
Wenn Sie ein Theme in eine Erweiterung einbinden möchten, lesen Sie die Dokumentation zur API theme.
Hinweis: Seit Mai 2019 müssen Themes signiert sein, damit sie installiert werden können (Firefox-Bug 1545109). Weitere Informationen finden Sie unter Signieren und Verteilen Ihres Add-ons.
Bildformate
Die folgenden Bildformate werden in allen Bildeigenschaften eines Themes unterstützt:
- JPEG
- PNG
- APNG
- SVG (animierte SVGs werden ab Firefox 59 unterstützt)
- GIF (animierte GIFs werden nicht unterstützt)
Syntax
Der Schlüssel theme ist ein Objekt mit den folgenden Eigenschaften:
| Name | Typ | Beschreibung |
|---|---|---|
images |
Object |
Ab Firefox 60 optional. Vor Firefox 60 erforderlich.
Ein JSON-Objekt, dessen Eigenschaften die Bilder repräsentieren, die
in verschiedenen Bereichen des Browsers angezeigt werden. Einzelheiten
zu den möglichen Eigenschaften dieses Objekts finden Sie unter
|
colors |
Object |
Erforderlich
Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener
Bereiche des Browsers repräsentieren. Einzelheiten zu den möglichen
Eigenschaften dieses Objekts finden Sie unter
|
properties |
Object |
Optional
Die Eigenschaften dieses Objekts beeinflussen, wie die Einträge in
|
images
Alle URLs sind relativ zur Datei manifest.json und können nicht auf eine externe URL verweisen.
Bilder sollten 200 Pixel hoch sein, damit sie den Kopfbereich vertikal stets vollständig ausfüllen.
| Name | Typ | Beschreibung |
|---|---|---|
theme_frame |
String oder Object |
Ein Vordergrundbild (angegeben durch den Pfad zu einer in der Erweiterung enthaltenen Bilddatei) oder ein CSS-Farbverlauf, das bzw. der dem Kopfbereich hinzugefügt und an dessen oberer rechter Ecke ausgerichtet wird. CSS-Farbverläufe werden ab Firefox 153 unterstützt. Hinweis: Chrome richtet das Bild an der oberen linken Ecke des Kopfbereichs aus. Wenn das Bild den Kopfbereich nicht ausfüllt, wird es gekachelt. Ab Firefox 60 auf Desktopgeräten optional. |
additional_backgrounds |
Array aus String oder Object |
Warnung: Die Eigenschaft
Ein Array zusätzlicher Hintergrundeinträge. Jeder Eintrag ist
entweder ein Pfad zu einer in der Erweiterung enthaltenen Bilddatei
oder ein CSS-Farbverlauf. Die
Einträge werden dem Kopfbereich hinzugefügt und hinter dem Eintrag
Optional
Standardmäßig werden alle Einträge an der oberen rechten Ecke des
Kopfbereichs ausgerichtet. Ihre Ausrichtung, ihr Wiederholungs- und
Größenverhalten sowie der Bereich des Browserfensters, in dem sie
dargestellt werden, lassen sich jedoch über
Da zusätzliche Hintergrundeinträge hinter dem Eintrag
|
CSS-Farbverlaufssyntax
Ein CSS-Farbverlauf wird als Objekt der Form { "GRADIENT_TYPE": "GRADIENT_PARAMS" } angegeben. Dabei gilt:
GRADIENT_TYPEist einer der folgenden Werte:linear-gradientradial-gradientconic-gradientrepeating-linear-gradientrepeating-radial-gradientrepeating-conic-gradient
GRADIENT_PARAMSenthält die Parameter der jeweiligen CSS-Farbverlaufsfunktion, wie unter CSS-Farbverlaufswerte beschrieben.
colors
Diese Eigenschaften definieren die Farben verschiedener Browserbereiche. Sie sind alle optional.
Hinweis:
Farbeigenschaften, die mit Firefox 157 (Nova) eingeführt wurden, werden in früheren Firefox-Versionen ignoriert. Verwenden Sie strict_min_version für Themes, die ausschließlich für Nova entwickelt wurden.
Wie sich diese Eigenschaften auf die Firefox-Benutzeroberfläche auswirken, zeigen die folgenden Abbildungen:
|
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
Hinweis: Wenn mehrere Farbeigenschaften eine Komponente beeinflussen, sind sie in der Reihenfolge ihrer Priorität aufgeführt.
Alle diese Eigenschaften können entweder als Zeichenfolge mit einem gültigen CSS-Farbwert (einschließlich Hexadezimalwerten) oder als RGB-Array angegeben werden, beispielsweise "tab_background_text": [ 107 , 99 , 23 ].
| Name | Beschreibung |
|---|---|
bookmark_text |
Die Farbe von Text und Symbolen in der Lesezeichen- und Suchleiste.
Wenn
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu den Farben von
Wenn Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
button_background_active |
Die Hintergrundfarbe gedrückter Schaltflächen in der Symbolleiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
button_background_hover |
Die Hintergrundfarbe von Schaltflächen in der Symbolleiste, wenn sich der Mauszeiger darüber befindet. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
icons |
Die Farbe der Symbolleistensymbole, ausgenommen die Symbole in der Suchleiste.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu den Farben von Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
icons_attention |
Die Farbe von Symbolleistensymbolen im Aufmerksamkeitszustand, etwa eines mit einem Stern versehenen Lesezeichensymbols oder des Symbols für einen abgeschlossenen Download.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu den Farben von Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
frame |
Die Hintergrundfarbe des Kopfbereichs. Sie wird in den Teilen
angezeigt, die nicht von den unter Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
frame_inactive |
Die Hintergrundfarbe des Kopfbereichs, wenn das Browserfenster
inaktiv ist. Sie wird in den Teilen angezeigt, die nicht von den unter
Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
ntp_background |
Die Hintergrundfarbe der Neuer-Tab-Seite. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
ntp_card_background |
Die Hintergrundfarbe der Karten auf der Neuer-Tab-Seite. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
ntp_text |
Die Textfarbe der Neuer-Tab-Seite.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Hinweis: In Nova wird der Text im Suchfeld nicht durch diese Eigenschaft gestaltet. Er verwendet die Standardtextfarbe. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
popup |
Die Hintergrundfarbe von Popups, etwa dem Dropdown-Menü der URL-Leiste und den Pfeil-Panels.
Hinweis: In Firefox 157 und höher (Nova) verwendet
das Dropdown-Menü der URL-Leiste weder Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
popup_border |
Die Rahmenfarbe von Popups. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
popup_highlight |
Die Hintergrundfarbe von Einträgen in Popups, die über die Tastatur hervorgehoben werden, etwa eines ausgewählten Eintrags im Dropdown-Menü der URL-Leiste.
Hinweis: Es wird empfohlen,
Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
popup_highlight_text |
Die Textfarbe hervorgehobener Einträge in Popups.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
popup_text |
Die Textfarbe von Popups.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu
Hinweis: In Firefox 157 und höher (Nova) verwendet
das Dropdown-Menü der URL-Leiste weder Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
sidebar |
Die Hintergrundfarbe der Seitenleiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
sidebar_border |
Die Farbe des Rahmens und der Trennlinie der Browserseitenleiste. Hinweis: In Firefox 157 und höher (Nova) enthält die neu gestaltete Seitenleiste keine Trennlinie mehr. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
sidebar_highlight |
Die Hintergrundfarbe hervorgehobener Zeilen in integrierten Seitenleisten.
Hinweis: In Firefox 157 und höher (Nova) behält eine hervorgehobene Zeile in der neu gestalteten Seitenleiste die Standardfarbe des Browsers bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
sidebar_highlight_text |
Die Textfarbe hervorgehobener Zeilen in Seitenleisten.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu
Hinweis: In Firefox 157 und höher (Nova) behält eine hervorgehobene Zeile in der neu gestalteten Seitenleiste die Standardtextfarbe des Browsers bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
sidebar_text |
Die Textfarbe von Seitenleisten.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_background_separator
|
Warnung: Die Farbe der vertikalen Trennlinie zwischen Hintergrund-Tabs. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_background_text |
Die Farbe des Textes in inaktiven Seiten-Tabs. Wenn weder
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_line |
Die Farbe der Linie am ausgewählten Tab. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_loading |
Die Farbe der Ladeanzeige und der Ladeanimation im Tab. Hinweis: In Firefox 157 und höher (Nova) behält die Ladeanzeige im Tab ihre Standardfarbe bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_selected |
Die Hintergrundfarbe des ausgewählten Tabs. Wird diese Eigenschaft
nicht verwendet, bestimmen
Hinweis: In Nova wurde der Schlagschatten des
ausgewählten Tabs entfernt. Damit ausgewählte Tabs deutlich
erkennbar sind, legen Sie für diese Eigenschaft eine Farbe fest,
die sich von Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
tab_text |
Ab Firefox 59 bestimmt diese Eigenschaft die Textfarbe des
ausgewählten Tabs. Wenn
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar |
Die Hintergrundfarbe der Navigationsleiste, der Lesezeichenleiste und des ausgewählten Tabs. Sie bestimmt auch die Hintergrundfarbe der Suchleiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_bottom_separator |
Die Farbe der Linie entlang des oberen und linken Randes des Bereichs, der die Webseite enthält. Sie trennt damit den Seiteninhalt von der darüberliegenden Symbolleiste und, sofern die Seitenleiste angezeigt wird, von der Seitenleiste links daneben. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field |
Die Hintergrundfarbe von Feldern in der Symbolleiste, etwa der URL-Leiste. Sie bestimmt auch die Hintergrundfarbe des Feldes Auf dieser Seite suchen. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field_border |
Die Rahmenfarbe von Feldern in der Symbolleiste. Sie bestimmt auch die Rahmenfarbe des Feldes Auf dieser Seite suchen. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field_border_focus |
Die Rahmenfarbe fokussierter Felder in der Symbolleiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field_focus |
Die Hintergrundfarbe fokussierter Felder in der Symbolleiste, etwa der URL-Leiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field_highlight |
Die Hintergrundfarbe zur Kennzeichnung von aktuell ausgewähltem Text
in der URL-Leiste (und in der Suchleiste, falls diese als separates
Feld konfiguriert ist).
Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
Hier legt |
toolbar_field_highlight_text |
Die Farbe des aktuell ausgewählten Textes in der URL-Leiste (und in der Suchleiste, falls diese als separates Feld konfiguriert ist).
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
Hier setzt |
toolbar_field_separator |
Warnung:
Die Farbe der Trennlinien innerhalb der URL-Leiste. In Firefox 58
wurde dies als Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
In diesem Screenshot ist |
toolbar_field_text |
Die Textfarbe von Feldern in der Symbolleiste, etwa der URL-Leiste. Sie bestimmt auch die Textfarbe des Feldes Auf dieser Seite suchen.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_field_text_focus |
Die Textfarbe fokussierter Felder in der Symbolleiste, etwa der URL-Leiste.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_text |
Die Textfarbe der Symbolleiste. Sie bestimmt auch die Textfarbe der Suchleiste.
Hinweis: Verwenden Sie für die Kompatibilität mit
Chrome den Alias Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_top_separator |
Die Farbe der Linie, die den oberen Rand der Symbolleiste vom darüberliegenden Bereich trennt. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
toolbar_vertical_separator |
Die Farbe der Trennlinie in der Lesezeichen-Symbolleiste. In Firefox 58 entspricht sie der Farbe der Trennlinien innerhalb der URL-Leiste. Beispiel ansehenjson
Firefox 157 und höher (Nova):
Firefox 156 und früher:
|
Aliase
Dieser Schlüssel akzeptiert außerdem verschiedene Eigenschaften als Aliase für die oben genannten Eigenschaften. Sie dienen der Kompatibilität mit Chrome. Wenn sowohl ein Alias als auch die entsprechende Eigenschaft ohne Alias angegeben sind, wird der Wert der Eigenschaft ohne Alias verwendet.
| Name | Alias für |
|---|---|
bookmark_text |
toolbar_text |
properties
| Name | Typ | Beschreibung |
|---|---|---|
additional_backgrounds_alignment |
|
Optional
Ein Array aus Aufzählungswerten, das die Ausrichtung des jeweiligen
Eintrags im Array
Enthält das Array weniger Einträge als
Wenn nichts angegeben ist, gilt standardmäßig |
additional_backgrounds_tiling |
|
Optional
Ein Array aus Aufzählungswerten, das festlegt, wie der jeweilige
Eintrag im Array
Enthält das Array weniger Einträge als
Wenn nichts angegeben ist, gilt standardmäßig |
additional_backgrounds_size |
|
Optional
Ein Array aus Werten, das die Größe des jeweiligen Eintrags im Array
Enthält das Array weniger Einträge als
Wenn nichts angegeben ist, gilt standardmäßig |
backgrounds_area |
|
Optional Bestimmt den Bereich des Browserfensters, in dem die Hintergrundbilder und Farbverläufe des Themes dargestellt werden. Folgende Werte sind möglich:
Wenn nichts angegeben ist, gilt standardmäßig |
color_scheme |
|
Optional Bestimmt, welches Farbschema auf die Browseroberfläche (beispielsweise Kontextmenüs) und auf Inhalte (beispielsweise integrierte Seiten und das bevorzugte Farbschema für Webseiten) angewendet wird. Folgende Werte sind möglich:
Wenn nichts angegeben ist, gilt standardmäßig |
content_color_scheme |
|
Optional
Bestimmt, welches Farbschema auf Inhalte angewendet wird,
beispielsweise auf integrierte Seiten und das bevorzugte Farbschema
für Webseiten. Überschreibt
Wenn nichts angegeben ist, gilt standardmäßig |
Beispiele
Ein einfaches Theme muss ein Bild für den Kopfbereich, die dort zu verwendende Akzentfarbe und die Textfarbe für den Kopfbereich definieren:
"theme": {
"images": {
"theme_frame": "images/sun.jpg"
},
"colors": {
"frame": "#CF723F",
"tab_background_text": "black"
}
}
Sie können mehrere Einträge verwenden, um den Kopfbereich auszufüllen. Verwenden Sie vor Firefox 60 ein leeres oder transparentes Bild für den Kopfbereich, um die Platzierung jedes zusätzlichen Eintrags steuern zu können:
"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 Kopfbereich auch mit einem oder mehreren wiederholten Bildern ausfüllen. In diesem Fall wird ein einzelnes Bild oben mittig im Kopfbereich verankert und über den restlichen Kopfbereich wiederholt:
"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"
}
}
Das Ergebnis sieht so aus:
Firefox 157 und höher (Nova):

Firefox 156 und früher:

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der URL-Leiste, die das Lesemodus-Symbol von den anderen Symbolen trennt.
Dieses Beispiel (Firefox 153 und höher) kombiniert Bildhintergründe mit einem linearen CSS-Farbverlauf:
"theme": {
"images": {
"additional_backgrounds": [
"background-image1.svg",
"background-image2.svg",
{ "linear-gradient": "to bottom, #FF6BBA -20%, #FFC999 50%" }
]
},
"properties": {
"additional_backgrounds_alignment": ["right top", "left top", "right top"],
"additional_backgrounds_tiling": ["no-repeat", "no-repeat", "repeat-x"],
"additional_backgrounds_size": ["auto", "auto", "auto 144px"]
}
}
Das Ergebnis:
background-image1.svgwird oben rechts in seiner natürlichen Größe angezeigt.background-image2.svgwird oben links in seiner natürlichen Größe angezeigt.- Der
linear-gradientbeginnt oben rechts, wird horizontal über den Kopfbereich gekachelt (repeat-x) und auf eine Höhe von 144px skaliert (die Breite wird automatisch bestimmt). Der Farbverlauf geht von Rosa (#FF6BBA) oben zu Pfirsichfarben (#FFC999) unten über.
Dieses Beispiel (Firefox 156 und höher) beschränkt den Hintergrundfarbverlauf auf die horizontalen Symbolleisten am oberen Fensterrand, sodass er sich nicht hinter die Seitenleiste oder vertikale Tabs erstreckt. Ohne backgrounds_area führt die Ausrichtung "right top" dazu, dass Firefox den Farbverlauf im gesamten Fenster darstellt:
"theme": {
"images": {
"additional_backgrounds": [
{ "linear-gradient": "to bottom, rgb(255, 0, 128), rgb(0, 128, 255)" }
]
},
"colors": {
"frame": "#000080",
"tab_background_text": "#ffffff"
},
"properties": {
"additional_backgrounds_alignment": ["right top"],
"additional_backgrounds_tiling": ["no-repeat"],
"additional_backgrounds_size": ["100% 100%"],
"backgrounds_area": "top_toolbars"
}
}
Wenn backgrounds_area auf "top_toolbars" gesetzt ist, verwendet die Seitenleiste die Farbe frame. Wenn Sie backgrounds_area stattdessen auf "window" setzen, erstreckt sich der Farbverlauf über das gesamte Fenster, einschließlich des Bereichs hinter der Seitenleiste.
Browser-Kompatibilität
Chrome-Kompatibilität
In Chrome:
-
colors/toolbar_textwird nicht verwendet; verwenden Sie stattdessencolors/bookmark_text. -
images/theme_framerichtet das Bild an der oberen linken Ecke des Kopfbereichs aus. Wenn das Bild den Kopfbereich nicht ausfüllt, wird es gekachelt. -
Alle Farben müssen als Array aus RGB-Werten angegeben werden, zum Beispiel:
json"theme": { "colors": { "frame": [255, 0, 0], "tab_background_text": [0, 255, 0], "bookmark_text": [0, 0, 255] } }Ab Firefox 59 werden für alle Eigenschaften sowohl die Array-Form als auch die CSS-Farbform akzeptiert. Davor war für
colors/frameundcolors/tab_background_textdie Array-Form erforderlich, während für andere Eigenschaften die CSS-Farbform erforderlich war.