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 festzulegen. 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, legt theme das Theme für das helle Farbschema fest.
Hinweis:
Wenn Sie einer Erweiterung ein Theme hinzufügen 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 Ihr Add-on signieren und verteilen.
Bildformate
Die folgenden Bildformate werden für alle Bild-Eigenschaften von Themes unterstützt:
- JPEG
- PNG
- APNG
- SVG (animiertes SVG wird ab Firefox 59 unterstützt)
- GIF (animiertes GIF wird 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 für verschiedene
Bereiche des Browsers festlegen. Unter
|
colors |
Object |
Erforderlich
Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener
Bereiche des Browsers festlegen. Unter
|
properties |
Object |
Optional
Dieses Objekt enthält Eigenschaften, die beeinflussen, wie die
Einträge unter |
images
Alle URLs sind relativ zur Datei manifest.json und dürfen nicht auf eine externe URL verweisen.
Bilder sollten 200 Pixel hoch sein, damit sie den Kopfbereich vertikal immer 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 beziehungsweise der zum Kopfbereich hinzugefügt und an dessen oberer rechter Ecke verankert wird. CSS-Farbverläufe werden ab Firefox 153 unterstützt. Hinweis: Chrome verankert das Bild oben links im Kopfbereich und wiederholt es kachelartig, wenn es den Kopfbereich nicht vollständig ausfüllt. Ab Firefox 60 für Desktop-Systeme optional. |
additional_backgrounds |
Array aus String oder Object |
Warnung: Die Eigenschaft
Ein Array zusätzlicher Hintergründe. Jeder Eintrag ist entweder der
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 sind alle Einträge an der oberen rechten Ecke des
Kopfbereichs verankert. Ihre Ausrichtung, Wiederholung und Größe
sowie der Bereich des Browserfensters, in dem sie gezeichnet werden,
lassen sich jedoch über
Da zusätzliche Hintergründe hinter dem Eintrag
|
Syntax für CSS-Farbverläufe
Ein CSS-Farbverlauf wird als Objekt in 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 legen die Farben verschiedener Bereiche des Browsers fest. 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 nur für Nova vorgesehen sind.
Wie sich diese Eigenschaften auf die Firefox-Benutzeroberfläche auswirken, ist hier dargestellt:
|
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
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 der Suchleiste.
Wenn
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu
Wenn Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
button_background_active |
Die Hintergrundfarbe gedrückter Schaltflächen in der Symbolleiste. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
button_background_hover |
Die Hintergrundfarbe von Schaltflächen in der Symbolleiste, wenn sich der Mauszeiger darüber befindet. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
icons |
Die Farbe der Symbole in der Symbolleiste, ausgenommen die Symbole in der Suchleiste.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
icons_attention |
Die Farbe von Symbolleisten-Symbolen im Aufmerksamkeitszustand, beispielsweise des mit einem Stern markierten Lesezeichen-Symbols oder des Symbols für einen abgeschlossenen Download.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
frame |
Die Hintergrundfarbe des Kopfbereichs. Sie wird dort angezeigt, wo
der Kopfbereich nicht von den unter Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
frame_inactive |
Die Hintergrundfarbe des Kopfbereichs bei einem inaktiven
Browserfenster. Sie wird dort angezeigt, wo der Kopfbereich nicht
von den unter Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
ntp_background |
Die Hintergrundfarbe der Neuer-Tab-Seite. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
ntp_card_background |
Die Hintergrundfarbe der Karten auf der Neuer-Tab-Seite. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
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 anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
popup |
Die Hintergrundfarbe von Popups, beispielsweise des Dropdown-Menüs der Adressleiste und der Pfeil-Panels.
Hinweis: In Firefox 157 und neuer (Nova) verwendet
das Dropdown-Menü der Adressleiste weder Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
popup_border |
Die Rahmenfarbe von Popups. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
popup_highlight |
Die Hintergrundfarbe von Einträgen, die innerhalb von Popups per Tastatur hervorgehoben werden, beispielsweise eines ausgewählten Eintrags im Dropdown-Menü der Adressleiste.
Hinweis: Es wird empfohlen,
Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
popup_highlight_text |
Die Textfarbe hervorgehobener Einträge in Popups.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
popup_text |
Die Textfarbe von Popups.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu
Hinweis: In Firefox 157 und neuer (Nova) verwendet
das Dropdown-Menü der Adressleiste weder Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
sidebar |
Die Hintergrundfarbe der Sidebar. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
sidebar_border |
Die Farbe des Rahmens und der Trennlinie der Browser-Sidebar. Hinweis: In Firefox 157 und neuer (Nova) enthält die neu gestaltete Sidebar keine Trennlinie mehr. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
sidebar_highlight |
Die Hintergrundfarbe hervorgehobener Zeilen in integrierten Sidebars.
Hinweis: In Firefox 157 und neuer (Nova) behält eine hervorgehobene Zeile in der neu gestalteten Sidebar die Standardfarbe des Browsers bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
sidebar_highlight_text |
Die Textfarbe hervorgehobener Zeilen in Sidebars.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu
Hinweis: In Firefox 157 und neuer (Nova) behält eine hervorgehobene Zeile in der neu gestalteten Sidebar die Standardtextfarbe des Browsers bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
sidebar_text |
Die Textfarbe von Sidebars.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
tab_background_text |
Die Farbe des Textes in inaktiven Tabs. Wenn weder
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
tab_line |
Die Farbe der Linie des ausgewählten Tabs. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
tab_loading |
Die Farbe der Ladeanzeige im Tab und der Animation beim Laden des Tabs. Hinweis: In Firefox 157 und neuer (Nova) behält die Ladeanzeige im Tab ihre Standardfarbe bei. Diese Eigenschaft hat daher keine sichtbare Wirkung. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
tab_selected |
Die Hintergrundfarbe des ausgewählten Tabs. Wenn diese Eigenschaft
nicht verwendet wird, bestimmen
Hinweis: In Nova wurde der Schlagschatten des
ausgewählten Tabs entfernt. Damit ausgewählte Tabs gut erkennbar
bleiben, legen Sie für diese Eigenschaft eine Farbe fest, die
einen Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
tab_text |
Ab Firefox 59 legt diese Eigenschaft die Textfarbe des ausgewählten
Tabs fest. Wenn
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar |
Die Hintergrundfarbe der Navigationsleiste, der Lesezeichenleiste und des ausgewählten Tabs. Sie legt außerdem die Hintergrundfarbe der Suchleiste fest. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_bottom_separator |
Die Farbe der Linie am oberen und linken Rand des Bereichs, der die Webseite enthält. Sie trennt damit den Seiteninhalt von der darüberliegenden Symbolleiste und, falls die Sidebar angezeigt wird, von der links daneben befindlichen Sidebar. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field |
Die Hintergrundfarbe von Feldern in der Symbolleiste, beispielsweise der Adressleiste. Sie legt außerdem die Hintergrundfarbe des Feldes Auf Seite suchen fest. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field_border |
Die Rahmenfarbe von Feldern in der Symbolleiste. Sie legt außerdem die Rahmenfarbe des Feldes Auf Seite suchen fest. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field_border_focus |
Die Rahmenfarbe von Feldern in der Symbolleiste, wenn sie den Fokus haben. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field_focus |
Die Hintergrundfarbe von Feldern in der Symbolleiste, beispielsweise der Adressleiste, wenn sie den Fokus haben. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field_highlight |
Die Hintergrundfarbe zur Kennzeichnung der aktuellen Textauswahl in
der Adressleiste und, falls separat konfiguriert, in der Suchleiste.
Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
Hier legt |
toolbar_field_highlight_text |
Die Farbe von ausgewähltem Text in der Adressleiste und, falls separat konfiguriert, in der Suchleiste.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
Hier legt |
toolbar_field_text |
Die Textfarbe von Feldern in der Symbolleiste, beispielsweise der Adressleiste. Sie legt außerdem die Textfarbe des Feldes Auf Seite suchen fest.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_field_text_focus |
Die Textfarbe von Feldern in der Symbolleiste, beispielsweise der Adressleiste, wenn sie den Fokus haben.
Hinweis: Achten Sie darauf, dass die verwendete
Farbe einen guten Kontrast zu Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_text |
Die Textfarbe der Symbolleiste. Sie legt außerdem die Textfarbe der Suchleiste fest.
Hinweis: Verwenden Sie für die Kompatibilität
mit Chrome den Alias Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_top_separator |
Die Farbe der Linie, die den oberen Rand der Symbolleiste vom darüberliegenden Bereich trennt. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
toolbar_vertical_separator |
Die Farbe der Trennlinie in der Lesezeichen-Symbolleiste. In Firefox 58 entspricht sie der Farbe der Trennlinien innerhalb der Adressleiste. Beispiel anzeigenjson
Firefox 157 und neuer (Nova):
Firefox 156 und älter:
|
Aliasse
Dieser Schlüssel akzeptiert außerdem verschiedene Eigenschaften als Aliasse für die oben aufgeführten 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 von Aufzählungswerten, die die Ausrichtung des jeweiligen
Array-Eintrags unter
Enthält das Array weniger Einträge als das Array
Wenn nichts angegeben ist, wird standardmäßig |
additional_backgrounds_tiling |
|
Optional
Ein Array von Aufzählungswerten, die festlegen, wie der jeweilige
Array-Eintrag unter
Enthält das Array weniger Einträge als das Array
Wenn nichts angegeben ist, wird standardmäßig |
additional_backgrounds_size |
|
Optional
Ein Array von Werten, die die Größe des jeweiligen Array-Eintrags
unter
Enthält das Array weniger Einträge als das Array
Wenn nichts angegeben ist, wird standardmäßig |
backgrounds_area |
|
Optional Bestimmt den Bereich des Browserfensters, in dem die Hintergrundbilder und Farbverläufe des Themes gezeichnet werden. Mögliche Werte sind:
Wenn nichts angegeben ist, wird 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. Mögliche Werte sind:
Wenn nichts angegeben ist, wird 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, wird standardmäßig |
Beispiele
Ein einfaches Theme muss ein Bild für den Kopfbereich, die dort verwendete Akzentfarbe und die Textfarbe des Kopfbereichs festlegen:
"theme": {
"images": {
"theme_frame": "images/sun.jpg"
},
"colors": {
"frame": "#CF723F",
"tab_background_text": "black"
}
}
Mehrere Einträge können den Kopfbereich ausfüllen. Verwenden Sie vor Firefox 60 ein leeres oder transparentes Bild für den Kopfbereich, um die Platzierung der zusätzlichen Einträge 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. Im folgenden Fall wird ein einzelnes Bild oben mittig im Kopfbereich verankert und über den restlichen Kopfbereich hinweg 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 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"
}
}
Damit erhalten Sie einen Browser, der so aussieht:
Firefox 157 und neuer (Nova):

Firefox 156 und älter:

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der Adressleiste, die das Symbol für den Lesemodus von den anderen Symbolen trennt.
Dieses Beispiel (Firefox 153 und neuer) 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 wiederholt (repeat-x) und ist 144px hoch (die Breite wird automatisch bestimmt). Der Farbverlauf geht von Rosa (#FF6BBA) oben zu Pfirsichfarben (#FFC999) unten über.
Dieses Beispiel (Firefox 156 und neuer) beschränkt den Hintergrund-Farbverlauf auf die horizontalen Symbolleisten am oberen Fensterrand, damit er sich nicht hinter die Sidebar oder vertikale Tabs erstreckt. Ohne backgrounds_area führt die Ausrichtung "right top" dazu, dass Firefox den Farbverlauf im gesamten Fenster zeichnet:
"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 Sidebar die Farbe frame. Wird backgrounds_area stattdessen auf "window" gesetzt, erstreckt sich der Farbverlauf über das gesamte Fenster, einschließlich des Bereichs hinter der Sidebar.
Browser-Kompatibilität
Chrome-Kompatibilität
In Chrome gilt:
-
colors/toolbar_textwird nicht verwendet. Verwenden Sie stattdessencolors/bookmark_text. -
images/theme_frameverankert das Bild oben links im Kopfbereich und wiederholt es kachelartig, wenn es den Kopfbereich nicht vollständig ausfüllt. -
Alle Farben müssen als Array von RGB-Werten angegeben werden, beispielsweise so:
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. Zuvor erforderten colors/frame und colors/tab_background_text die Array-Form, während die anderen Eigenschaften die CSS-Farbform erforderten.