Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

theme

Typ Object
Erforderlich Nein
Manifest-Version 2 oder höher
Beispiel
json
"theme": {
  "images": {
    "theme_frame": "images/sun.jpg"
  },
  "colors": {
    "frame": "#CF723F",
    "tab_background_text": "black"
  }
}

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 images finden Sie Einzelheiten zu den möglichen Eigenschaften dieses Objekts.

colors Object

Erforderlich

Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener Bereiche des Browsers festlegen. Unter colors finden Sie Einzelheiten zu den möglichen Eigenschaften dieses Objekts.

properties Object

Optional

Dieses Objekt enthält Eigenschaften, die beeinflussen, wie die Einträge unter "additional_backgrounds" angezeigt und Farbschemata angewendet werden. Unter properties finden Sie Einzelheiten zu den möglichen Eigenschaften dieses Objekts.

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 additional_backgrounds ist experimentell. Sie wird in veröffentlichten Firefox-Versionen unterstützt, ihr Verhalten kann sich jedoch ändern.

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 "theme_frame": angezeigt. Der erste Eintrag des Arrays liegt dabei ganz oben, der letzte ganz unten. CSS-Farbverläufe werden ab Firefox 153 unterstützt.

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 "properties": steuern.

Da zusätzliche Hintergründe hinter dem Eintrag theme_frame angezeigt werden, sind sie nicht sichtbar, wenn theme_frame als CSS-Farbverlauf festgelegt ist.

Syntax für CSS-Farbverläufe

Ein CSS-Farbverlauf wird als Objekt in der Form { "GRADIENT_TYPE": "GRADIENT_PARAMS" } angegeben. Dabei gilt:

  • GRADIENT_TYPE ist einer der folgenden Werte:
    • linear-gradient
    • radial-gradient
    • conic-gradient
    • repeating-linear-gradient
    • repeating-radial-gradient
    • repeating-conic-gradient
  • GRADIENT_PARAMS enthä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): Übersicht der Farbeigenschaften und ihrer Anwendung auf Komponenten der Firefox-Benutzeroberfläche in Nova

Firefox 156 und älter: Übersicht der Farbeigenschaften und ihrer Anwendung auf Komponenten der Firefox-Benutzeroberfläche

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 tab_text nicht definiert ist, legt sie außerdem die Textfarbe des aktiven Tabs fest; wenn icons nicht definiert ist, die Farbe der Symbolleisten-Symbole. Die Eigenschaft dient als Chrome-kompatibler Alias für toolbar_text.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu frame und frame_inactive beziehungsweise zu toolbar bietet, falls Sie diese Eigenschaft verwenden.

Wenn icons nicht definiert ist, achten Sie außerdem auf einen guten Kontrast zu button_background_active und button_background_hover.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "tab_text": "white",
    "toolbar": "black",
    "bookmark_text": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab ist schwarz und hat weißen Text. Die Adressleiste und die Seiten-Suchleiste sind weiß und haben schwarzen Text; alle Browser- und Suchleisten-Symbole sind jedoch rot.

Firefox 156 und älter: Firefox ist schwarz. Der Tab ist schwarz und hat weißen Text. Die Adressleiste und die Seiten-Suchleiste sind weiß und haben schwarzen Text; alle Browser- und Suchleisten-Symbole sind jedoch rot.

button_background_active

Die Hintergrundfarbe gedrückter Schaltflächen in der Symbolleiste.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "button_background_active": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das weiße Symbol zum Anpassen der Symbolleiste in der Adressleiste ist auf rotem Hintergrund gedrückt. Ein geöffnetes Popup zeigt eine kurze Liste von Elementen, die der Symbolleiste hinzugefügt werden können, etwa die Bibliothek und die Sidebars.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das weiße Symbol zum Anpassen der Symbolleiste in der Adressleiste ist auf rotem Hintergrund gedrückt. Ein geöffnetes Popup zeigt eine kurze Liste von Elementen, die der Symbolleiste hinzugefügt werden können, etwa die Bibliothek und die Sidebars.

button_background_hover

Die Hintergrundfarbe von Schaltflächen in der Symbolleiste, wenn sich der Mauszeiger darüber befindet.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "button_background_hover": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das weiße Symbol zum Zurückgehen um eine Seite hat einen roten, kreisförmigen Hintergrund.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das weiße Symbol zum Zurückgehen um eine Seite hat einen roten, kreisförmigen Hintergrund.

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 frame, frame_inactive, button_background_active und button_background_hover bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Die Symbole in der Adressleiste und zum Öffnen eines neuen Tabs sind rot. Die roten Symbole heben sich gut vom schwarzen Hintergrund des Kopfbereichs ab.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Die Symbole in der Adressleiste und zum Öffnen eines neuen Tabs sind rot. Die roten Symbole heben sich gut vom schwarzen Hintergrund des Kopfbereichs ab.

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 frame, frame_inactive, button_background_active und button_background_hover bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons_attention": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das rote Symbol zum Setzen eines Lesezeichens ist gedrückt; das Popup zum Bearbeiten des Lesezeichens ist geöffnet. Im Aufmerksamkeitszustand heben sich die Symbole gut vom schwarzen Hintergrund des Kopfbereichs ab.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind grau und haben weißen Text. Das rote Symbol zum Setzen eines Lesezeichens ist gedrückt; das Popup zum Bearbeiten des Lesezeichens ist geöffnet. Im Aufmerksamkeitszustand heben sich die Symbole gut vom schwarzen Hintergrund des Kopfbereichs ab.

frame

Die Hintergrundfarbe des Kopfbereichs. Sie wird dort angezeigt, wo der Kopfbereich nicht von den unter "theme_frame" und "additional_backgrounds" angegebenen Einträgen bedeckt ist oder durch diese hindurch sichtbar bleibt.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "red",
     "tab_background_text": "white"
  }
}

Firefox 157 und neuer (Nova): Firefox ist rot und hat weißen Text. Die Tabs sind heller rot und haben ebenfalls weißen Text. Die Adressleiste ist sehr hellrot und hat schwarzen Text.

Firefox 156 und älter: Firefox ist rot und hat weißen Text. Die Tabs sind heller rot und haben ebenfalls weißen Text. Die Adressleiste ist sehr hellrot und hat schwarzen Text.

frame_inactive

Die Hintergrundfarbe des Kopfbereichs bei einem inaktiven Browserfenster. Sie wird dort angezeigt, wo der Kopfbereich nicht von den unter "theme_frame" und "additional_backgrounds" angegebenen Einträgen bedeckt ist oder durch diese hindurch sichtbar bleibt.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "red",
     "frame_inactive": "gray",
     "tab_text": "white"
  }
}

Firefox 157 und neuer (Nova): Firefox ist grau. Die Tabs und die Adressleiste sind heller grau. Der Tab-Text ist weiß, und die Symbole in der Adressleiste sind dunkler grau.

Firefox 156 und älter: Firefox ist grau. Die Tabs und die Adressleiste sind heller grau. Der Tab-Text ist weiß, und die Symbole in der Adressleiste sind dunkler grau.

ntp_background

Die Hintergrundfarbe der Neuer-Tab-Seite.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "ntp_background": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox zeigt eine Neuer-Tab-Seite mit rotem Hintergrund.

Firefox 156 und älter: Firefox zeigt eine Neuer-Tab-Seite mit rotem Hintergrund.

ntp_card_background

Die Hintergrundfarbe der Karten auf der Neuer-Tab-Seite.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "ntp_card_background": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox zeigt eine Neuer-Tab-Seite. Die Hintergründe des Suchfelds und der Verknüpfungsschaltflächen sind rot.

Firefox 156 und älter: Firefox zeigt eine Neuer-Tab-Seite. Die Hintergründe des Suchfelds und der Verknüpfungsschaltflächen sind rot.

ntp_text

Die Textfarbe der Neuer-Tab-Seite.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu ntp_background und ntp_card_background bietet.

Hinweis: In Nova wird der Text im Suchfeld nicht durch diese Eigenschaft gestaltet. Er verwendet die Standardtextfarbe.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "ntp_text": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox zeigt eine Neuer-Tab-Seite mit rotem Text.

Firefox 156 und älter: Firefox zeigt eine Neuer-Tab-Seite mit rotem Text.

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 popup noch popup_text, sondern behält die Standardfarben des Browsers bei.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Das blaue Symbol zum Setzen eines Lesezeichens ist gedrückt. Das geöffnete Popup zum Bearbeiten des Lesezeichens hat einen roten Hintergrund.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Das blaue Symbol zum Setzen eines Lesezeichens ist gedrückt. Das geöffnete Popup zum Bearbeiten des Lesezeichens hat einen roten Hintergrund.

popup_border

Die Rahmenfarbe von Popups.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "black",
     "popup_text": "white",
     "popup_border": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Das blaue Symbol zum Setzen eines Lesezeichens ist gedrückt. Das geöffnete Popup zum Bearbeiten des Lesezeichens hat einen schwarzen Hintergrund und einen roten Rahmen.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Das blaue Symbol zum Setzen eines Lesezeichens ist gedrückt. Das geöffnete Popup zum Bearbeiten des Lesezeichens hat einen schwarzen Hintergrund und einen roten Rahmen.

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, popup_highlight_text festzulegen, um die Standardtextfarbe des Browsers auf verschiedenen Plattformen zu überschreiben.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup_highlight": "red",
     "popup_highlight_text": "white"
  }
}

Firefox 157 und neuer (Nova): Screenshot von Firefox mit schwarzem Hintergrund. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Ein Popup mit Suchergebnissen ist geöffnet; der Hintergrund eines hervorgehobenen Eintrags ist rot.

Firefox 156 und älter: Screenshot von Firefox mit schwarzem Hintergrund. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Ein Popup mit Suchergebnissen ist geöffnet; der Hintergrund eines hervorgehobenen Eintrags ist rot.

popup_highlight_text

Die Textfarbe hervorgehobener Einträge in Popups.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu popup_highlight bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup_highlight": "black",
     "popup_highlight_text": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. In einem Popup mit Suchergebnissen hat ein hervorgehobener Eintrag roten Text auf schwarzem Hintergrund. Der Text hebt sich gut vom Hintergrund ab.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. In einem Popup mit Suchergebnissen hat ein hervorgehobener Eintrag roten Text auf schwarzem Hintergrund. Der Text hebt sich gut vom Hintergrund ab.

popup_text

Die Textfarbe von Popups.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu popup bietet.

Hinweis: In Firefox 157 und neuer (Nova) verwendet das Dropdown-Menü der Adressleiste weder popup noch popup_text, sondern behält die Standardfarben des Browsers bei.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "black",
     "popup_text": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox mit schwarzem Kopfbereich und weißem Tab-Text. Das Panel zum Hinzufügen eines Lesezeichens ist geöffnet. Es hat einen schwarzen Hintergrund sowie rote Beschriftungen, Felder und Schaltflächen.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind heller grau und haben weiße Symbole und weißen Text. Ein Popup mit Suchergebnissen zeigt rote Eintragstexte, die sich gut vom schwarzen Hintergrund des Popups abheben.

sidebar

Die Hintergrundfarbe der Sidebar.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "sidebar": "red",
     "sidebar_highlight": "white",
     "sidebar_highlight_text": "green",
     "sidebar_text": "white"
  }
}

Firefox 157 und neuer (Nova): Nahaufnahme der geöffneten Sidebar eines Browserfensters. Der Hintergrund der Sidebar ist rot.

Firefox 156 und älter: Nahaufnahme der geöffneten Sidebar eines Browserfensters. Der Hintergrund der Sidebar ist rot.

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 anzeigen
json
"theme": {
  "colors": {
     "sidebar_border": "red"
  }
}

Firefox 157 und neuer (Nova): Nahaufnahme der Lesezeichen-Sidebar in Firefox mit einer roten horizontalen Trennlinie zwischen dem Titel und dem Menü der Sidebar. Die Rahmen- und Trennlinienfarbe der Sidebar ist rot.

Firefox 156 und älter: Nahaufnahme der Lesezeichen-Sidebar in Firefox mit einer roten horizontalen Trennlinie zwischen dem Titel und dem Menü der Sidebar. Die Rahmen- und Trennlinienfarbe der Sidebar ist rot.

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 anzeigen
json
"theme": {
  "colors": {
     "sidebar_highlight": "red",
     "sidebar_highlight_text": "white"
  }
}

Firefox 157 und neuer (Nova): Die Lesezeichen-Sidebar mit einer hervorgehobenen Zeile. Statt des durch das Theme festgelegten Rots behält die Zeile den standardmäßigen lavendelfarbenen Hintergrund des Browsers.

Firefox 156 und älter: Nahaufnahme der Lesezeichen-Sidebar in Firefox mit einem hervorgehobenen Eintrag. Die hervorgehobene Zeile hat einen roten Hintergrund und weißen Text.

sidebar_highlight_text

Die Textfarbe hervorgehobener Zeilen in Sidebars.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu sidebar_highlight bietet.

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 anzeigen
json
"theme": {
  "colors": {
    "sidebar_highlight": "pink",
    "sidebar_highlight_text": "red",
  }
}

Firefox 157 und neuer (Nova): Die Lesezeichen-Sidebar mit einer hervorgehobenen Zeile. Statt des durch das Theme festgelegten Rots behält die Beschriftung der Zeile die Standardfarbe des Browsers.

Firefox 156 und älter: Nahaufnahme der Lesezeichen-Sidebar in Firefox mit einem hervorgehobenen Eintrag. Der Text der hervorgehobenen Zeile ist rot und hebt sich gut vom rosa Hintergrund ab.

sidebar_text

Die Textfarbe von Sidebars.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu sidebar bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "sidebar": "red",
     "sidebar_highlight": "white",
     "sidebar_highlight_text": "green",
     "sidebar_text": "white"
  }
}

Firefox 157 und neuer (Nova): Nahaufnahme der geöffneten Sidebar eines Browserfensters. Der Text in der Sidebar ist weiß und hebt sich gut vom roten Hintergrund ab.

Firefox 156 und älter: Nahaufnahme der geöffneten Sidebar eines Browserfensters. Der Text in der Sidebar ist weiß und hebt sich gut vom roten Hintergrund ab.

tab_background_text

Die Farbe des Textes in inaktiven Tabs. Wenn weder tab_text noch bookmark_text angegeben ist, gilt sie auch für den Text des aktiven Tabs.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu tab_selected beziehungsweise zu frame und frame_inactive bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "white",
    "tab_background_text": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind weiß und haben rote Symbole und roten Text. Der Text im geöffneten Tab ist rot und hebt sich gut vom schwarzen Hintergrund des Tabs ab.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind weiß und haben rote Symbole und roten Text. Der Text im geöffneten Tab ist rot und hebt sich gut vom schwarzen Hintergrund des Tabs ab.

tab_line

Die Farbe der Linie des ausgewählten Tabs.

Beispiel anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_line": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Die Tabs und die Adressleiste sind dunkelgrau und haben hellgraue Symbole und weißen Text. Der ausgewählte Tab hat eine rote Umrandung.

Firefox 156 und älter: Firefox ist schwarz. Die Tabs und die Adressleiste sind dunkelgrau und haben hellgraue Symbole und weißen Text. Der ausgewählte Tab hat eine rote Umrandung.

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 anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_loading": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox mit schwarzem Kopfbereich und weißem Tab-Text lädt eine Seite. Die Ladeanzeige im Tab ist standardmäßig grau statt des durch das Theme festgelegten Rots.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind dunkelgrau und haben weiße Symbole und weißen Text. Im ausgewählten Tab ist eine animierte rote Ladeanzeige zu sehen.

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Wenn diese Eigenschaft nicht verwendet wird, bestimmen frame und frame_inactive die Farbe des ausgewählten Tabs.

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 frame und frame_inactive bietet.

Beispiel anzeigen
json
"theme": {
  "images": {
  "theme_frame": "weta.png"
},
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_selected": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind dunkelgrau und haben weiße Symbole und weißen Text. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind dunkelgrau und haben weiße Symbole und weißen Text. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

tab_text

Ab Firefox 59 legt diese Eigenschaft die Textfarbe des ausgewählten Tabs fest. Wenn tab_line nicht angegeben ist, bestimmt sie außerdem die Farbe der Linie des ausgewählten Tabs.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu tab_selected beziehungsweise zu frame und frame_inactive bietet.

Beispiel anzeigen
json
"theme": {
  "images": {
  "theme_frame": "weta.png"
},
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_selected": "white",
     "tab_text": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox verwendet ein Theme mit einem Insektenbild. Die Adressleiste ist heller grau und hat weiße Symbole. Der Text des ausgewählten Tabs ist rot auf weißem Hintergrund.

Firefox 156 und älter: Firefox verwendet ein Theme mit einem Insektenbild. Die Adressleiste ist heller grau und hat weiße Symbole. Der Text des ausgewählten Tabs ist rot auf weißem Hintergrund.

toolbar

Die Hintergrundfarbe der Navigationsleiste, der Lesezeichenleiste und des ausgewählten Tabs.

Sie legt außerdem die Hintergrundfarbe der Suchleiste fest.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "red",
    "tab_background_text": "white"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind rot und haben weiße Texte und Symbole. In der Seiten-Suchleiste sind Text und Symbole jedoch schwarz.

Firefox 156 und älter: Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind rot und haben weiße Texte und Symbole. In der Seiten-Suchleiste sind Text und Symbole jedoch schwarz.

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 anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar_bottom_separator": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz, hat weißen Tab-Text und zeigt die Symbole der Sidebar an. Eine rote Linie verläuft am oberen und linken Rand des Webseitenbereichs und trennt ihn von der darüberliegenden Symbolleiste sowie der Sidebar links daneben.

Firefox 156 und älter: Firefox ist schwarz. Der Tab und die Adressleiste sind heller grau und haben weiße Texte und Symbole. Eine horizontale rote Linie trennt die Symbolleiste vom darunter angezeigten Webseitenbereich.

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 anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar_field": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind heller grau und haben weiße Texte und Symbole. Der Hintergrund der Adressleiste ist rot. Die Seiten-Suchleiste ist weiß und hat schwarzen Text; ihr Suchfeld ist rot und hat schwarzen Text.

Firefox 156 und älter: Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind heller grau und haben weiße Texte und Symbole. Der Hintergrund der Adressleiste ist rot. Die Seiten-Suchleiste ist weiß und hat schwarzen Text; ihr Suchfeld ist rot und hat schwarzen Text.

toolbar_field_border

Die Rahmenfarbe von Feldern in der Symbolleiste.

Sie legt außerdem die Rahmenfarbe des Feldes Auf Seite suchen fest.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_border": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste und das Suchfeld der Seiten-Suchleiste sind rot umrandet.

Firefox 156 und älter: Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste und das Suchfeld der Seiten-Suchleiste sind rot umrandet.

toolbar_field_border_focus

Die Rahmenfarbe von Feldern in der Symbolleiste, wenn sie den Fokus haben.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_border_focus": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste hat den Fokus und ist rot umrandet.

Firefox 156 und älter: Firefox ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste hat den Fokus und ist rot umrandet.

toolbar_field_focus

Die Hintergrundfarbe von Feldern in der Symbolleiste, beispielsweise der Adressleiste, wenn sie den Fokus haben.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_focus": "red"
  }
}

Firefox 157 und neuer (Nova): Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die fokussierte Adressleiste hat einen roten Hintergrund und weißen Text.

Firefox 156 und älter: Firefox ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die fokussierte Adressleiste hat einen roten Hintergrund und weißen Text.

toolbar_field_highlight Die Hintergrundfarbe zur Kennzeichnung der aktuellen Textauswahl in der Adressleiste und, falls separat konfiguriert, in der Suchleiste.
Beispiel anzeigen
json
"theme": {
  "colors": {
    "toolbar_field": "rgb(255 255 255 / 91%)",
    "toolbar_field_text": "rgb(0 100 0)",
    "toolbar_field_highlight": "rgb(180 240 180 / 90%)",
    "toolbar_field_highlight_text": "rgb(0 80 0)"
  }
}

Firefox 157 und neuer (Nova): Firefox ist weiß. Der Tab und die Adressleiste sind weiß und haben schwarzen Text und schwarze Symbole. Die Adressleiste hat den Fokus, ist blau umrandet und ihr Text ist ausgewählt.

Firefox 156 und älter: Firefox ist weiß. Der Tab und die Adressleiste sind weiß und haben schwarzen Text und schwarze Symbole. Die Adressleiste hat den Fokus, ist blau umrandet und ihr Text ist ausgewählt.

Hier legt toolbar_field_highlight ein helles Grün als Hervorhebungsfarbe fest, während toolbar_field_highlight_text den Text auf ein mittleres bis dunkles Grün setzt.

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 toolbar_field_highlight bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "toolbar_field": "rgb(255 255 255 / 91%)",
    "toolbar_field_text": "rgb(0 100 0)",
    "toolbar_field_highlight": "rgb(180 240 180 / 90%)",
    "toolbar_field_highlight_text": "rgb(0 80 0)"
  }
}

Firefox 157 und neuer (Nova): Firefox ist weiß. Der Tab und die Adressleiste sind weiß und haben schwarzen Text und schwarze Symbole. Die Adressleiste hat den Fokus, ist blau umrandet und ihr Text ist ausgewählt.

Firefox 156 und älter: Firefox ist weiß. Der Tab und die Adressleiste sind weiß und haben schwarzen Text und schwarze Symbole. Die Adressleiste hat den Fokus, ist blau umrandet und ihr Text ist ausgewählt.

Hier legt toolbar_field_highlight_text ein mittleres bis dunkles Grün als Textfarbe fest, während die Hervorhebungsfarbe hellgrün ist.

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 toolbar_field bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Der Text in der Adressleiste ist rot. Die Symbole und das Suchfeld der Seiten-Suchleiste haben roten Text auf schwarzem Hintergrund.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Der Text in der Adressleiste ist rot. Die Symbole und das Suchfeld der Seiten-Suchleiste haben roten Text auf schwarzem Hintergrund.

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 toolbar_field_focus bietet.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_text_focus": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste hat den Fokus; ihre Texte und Symbole sind rot auf schwarzem Hintergrund.

Firefox 156 und älter: Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die Adressleiste hat den Fokus; ihre Texte und Symbole sind rot auf schwarzem Hintergrund.

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 bookmark_text.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_text": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben rote Texte und Symbole. Der Text im aktiven Tab, in der Navigationsleiste und in der Suchleiste ist rot.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab, die Seiten-Suchleiste und die Adressleiste sind schwarz und haben rote Texte und Symbole. Der Text im aktiven Tab, in der Navigationsleiste und in der Suchleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die den oberen Rand der Symbolleiste vom darüberliegenden Bereich trennt.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_top_separator": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Eine rote Linie trennt den oberen Rand der Adressleiste vom darüberliegenden Browserbereich.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Eine rote Linie trennt den oberen Rand der Adressleiste vom darüberliegenden Browserbereich.

toolbar_vertical_separator

Die Farbe der Trennlinie in der Lesezeichen-Symbolleiste. In Firefox 58 entspricht sie der Farbe der Trennlinien innerhalb der Adressleiste.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_vertical_separator": "red"
  }
}

Firefox 157 und neuer (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die vertikale Linie zwischen der Lesezeichen-Symbolleiste und dem rechts davon befindlichen Inhalt ist rot.

Firefox 156 und älter: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die Adressleiste sind schwarz und haben weiße Texte und Symbole. Die vertikale Linie zwischen der Lesezeichen-Symbolleiste und dem rechts davon befindlichen Inhalt ist rot.

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

Array aus String

Optional

Ein Array von Aufzählungswerten, die die Ausrichtung des jeweiligen Array-Eintrags unter "additional_backgrounds": festlegen.
Mögliche Ausrichtungen sind:

  • "bottom"
  • "center"
  • "left"
  • "right"
  • "top"
  • "center bottom"
  • "center center"
  • "center top"
  • "left bottom"
  • "left center"
  • "left top"
  • "right bottom"
  • "right center"
  • "right top".

Enthält das Array weniger Einträge als das Array additional_backgrounds, werden seine Werte für die fehlenden Einträge erneut verwendet. Enthält additional_backgrounds beispielsweise 5 Werte und additional_backgrounds_alignment die Werte ["left", "top"], wird der dritte Hintergrund mit "left", der vierte mit "top" und der fünfte wieder mit "left" ausgerichtet.

Wenn nichts angegeben ist, wird standardmäßig "right top" verwendet.

additional_backgrounds_tiling

Array aus String

Optional

Ein Array von Aufzählungswerten, die festlegen, wie der jeweilige Array-Eintrag unter "additional_backgrounds": wiederholt wird. Mögliche Werte sind:

  • "no-repeat"
  • "repeat"
  • "repeat-x"
  • "repeat-y"

Enthält das Array weniger Einträge als das Array additional_backgrounds, werden seine Werte für die fehlenden Einträge erneut verwendet. Enthält additional_backgrounds beispielsweise 5 Werte und additional_backgrounds_tiling die Werte ["no-repeat", "repeat-x"], wird der dritte Hintergrund mit "no-repeat", der vierte mit "repeat-x" und der fünfte wieder mit "no-repeat" dargestellt.

Wenn nichts angegeben ist, wird standardmäßig "no-repeat" verwendet.

additional_backgrounds_size

Array aus String

Optional

Ein Array von Werten, die die Größe des jeweiligen Array-Eintrags unter "additional_backgrounds": festlegen. Akzeptiert dieselben Werte wie die CSS-Eigenschaft background-size, beispielsweise "auto", "cover", "contain" oder explizite Breiten- und Höhenangaben wie "100px 200px".

Enthält das Array weniger Einträge als das Array additional_backgrounds, werden seine Werte für die fehlenden Einträge erneut verwendet. Enthält additional_backgrounds beispielsweise 5 Werte und additional_backgrounds_size die Werte ["auto", "100px 100px"], wird für den dritten Hintergrund "auto", für den vierten "100px 100px" und für den fünften wieder "auto" verwendet.

Wenn nichts angegeben ist, wird standardmäßig "auto" verwendet.

backgrounds_area

String

Optional

Bestimmt den Bereich des Browserfensters, in dem die Hintergrundbilder und Farbverläufe des Themes gezeichnet werden. Mögliche Werte sind:

  • "auto" – Firefox wählt den Bereich anhand von additional_backgrounds_alignment aus. Wenn ein Ausrichtungswert einen Hintergrund vertikal in der Mitte oder unten im Kopfbereich positioniert, werden die Hintergründe in den oberen Symbolleisten gezeichnet. Andernfalls werden sie im Fenster gezeichnet.
  • "window" – die Hintergründe werden im gesamten Browserfenster gezeichnet und erstrecken sich damit auch hinter vertikale Elemente der Benutzeroberfläche, beispielsweise die Sidebar und vertikale Tabs.
  • "top_toolbars" – die Hintergründe werden nur in den horizontalen Symbolleisten am oberen Fensterrand gezeichnet: der Menüleiste, der Tableiste, der Navigations-Symbolleiste und der Lesezeichen-Symbolleiste. Vertikale Elemente der Benutzeroberfläche wie die Sidebar verwenden stattdessen die Farbe frame.

Wenn nichts angegeben ist, wird standardmäßig "auto" verwendet.

color_scheme

String

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:

  • "auto" – je nach Theme automatisch ein helles oder dunkles Farbschema.
  • "light" – ein helles Farbschema.
  • "dark" – ein dunkles Farbschema.
  • "system" – verwendet das Farbschema des Systems.

Wenn nichts angegeben ist, wird standardmäßig "auto" verwendet.

content_color_scheme

String

Optional

Bestimmt, welches Farbschema auf Inhalte angewendet wird, beispielsweise auf integrierte Seiten und das bevorzugte Farbschema für Webseiten. Überschreibt color_scheme. Mögliche Werte sind:

  • "auto" – je nach Theme automatisch ein helles oder dunkles Farbschema.
  • "light" – ein helles Farbschema.
  • "dark" – ein dunkles Farbschema.
  • "system" – das Farbschema des Systems.

Wenn nichts angegeben ist, wird standardmäßig "auto" verwendet.

Beispiele

Ein einfaches Theme muss ein Bild für den Kopfbereich, die dort verwendete Akzentfarbe und die Textfarbe des Kopfbereichs festlegen:

json
 "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:

json
 "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:

json
 "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:

json
  "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):

Ein Browserfenster mit zwei geöffneten Tabs und dunkelgrünem Hintergrund im Kopfbereich. Der inaktive Tab hat weißen Text. Der aktive Tab und die Symbolleiste haben einen blauen Hintergrund und cyanfarbenen Text. Die Adressleiste hat einen orangefarbenen Hintergrund, weiße Rahmen, grünen Text und eine weiße vertikale Trennlinie. Eine rote Linie trennt die Tabs oben, und eine weiße Linie trennt sie vom darunterliegenden Inhalt.

Firefox 156 und älter:

Ein Browserfenster mit zwei geöffneten Tabs und dunkelgrünem Hintergrund im Kopfbereich. Der inaktive Tab hat weißen Text. Der aktive Tab und die Symbolleiste haben einen blauen Hintergrund und cyanfarbenen Text. Die Adressleiste hat einen orangefarbenen Hintergrund, weiße Rahmen, grünen Text und eine weiße vertikale Trennlinie. Eine rote Linie trennt die Tabs oben, und eine weiße Linie trennt sie vom darunterliegenden Inhalt.

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:

json
"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.svg wird oben rechts in seiner natürlichen Größe angezeigt.
  • background-image2.svg wird oben links in seiner natürlichen Größe angezeigt.
  • Der linear-gradient beginnt 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:

json
"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_text wird nicht verwendet. Verwenden Sie stattdessen colors/bookmark_text.

  • images/theme_frame verankert 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.