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

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

properties Object

Optional

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

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

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

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

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

CSS-Farbverlaufssyntax

Ein CSS-Farbverlauf wird als Objekt 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 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): Übersicht über die Farbeigenschaften und ihre Auswirkungen auf Komponenten der Firefox-Benutzeroberfläche in Nova

Firefox 156 und früher: Übersicht über die Farbeigenschaften und ihre Auswirkungen 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 Suchleiste. Wenn tab_text nicht definiert ist, bestimmt sie außerdem die Textfarbe des aktiven Tabs. Wenn icons nicht definiert ist, bestimmt sie zudem die Farbe der Symbolleistensymbole. Diese Eigenschaft dient als Chrome-kompatibler Alias für toolbar_text.

Hinweis: Achten Sie darauf, dass die verwendete Farbe einen guten Kontrast zu den Farben von frame und frame_inactive bietet – beziehungsweise zu toolbar, 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 ansehen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "tab_text": "white",
    "toolbar": "black",
    "bookmark_text": "red"
  }
}

Firefox 157 und höher (Nova): Firefox ist schwarz. Der Tab ist schwarz mit weißem Text. Die URL-Leiste und die Leiste „Auf dieser Seite suchen“ sind weiß mit schwarzem Text, aber alle Browser- und Suchleistensymbole sind rot.

Firefox 156 und früher: Firefox ist schwarz. Der Tab ist schwarz mit weißem Text. Die URL-Leiste und die Leiste „Auf dieser Seite suchen“ sind weiß mit schwarzem Text, aber alle Browser- und Suchleistensymbole sind rot.

button_background_active

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

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Anpassen der Symbolleiste in der URL-Leiste ist weiß auf rotem Hintergrund und gedrückt. Ein geöffnetes Popup zeigt eine kurze Liste von Elementen, die der Symbolleiste hinzugefügt werden können, etwa die Browserbibliothek und die Seitenleisten.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Anpassen der Symbolleiste in der URL-Leiste ist weiß auf rotem Hintergrund und gedrückt. Ein geöffnetes Popup zeigt eine kurze Liste von Elementen, die der Symbolleiste hinzugefügt werden können, etwa die Browserbibliothek und die Seitenleisten.

button_background_hover

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

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Zurückblättern ist weiß und hat einen roten kreisförmigen Hintergrund.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Zurückblättern ist weiß und hat einen roten kreisförmigen Hintergrund.

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

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Die Symbole in der URL-Leiste und zum Öffnen eines neuen Tabs sind rot. Die roten Symbole heben sich gut vom schwarzen Hintergrund des Kopfbereichs ab.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Die Symbole in der URL-Leiste 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 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 frame, frame_inactive, button_background_active und button_background_hover bietet.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist rot und gedrückt; das Popup „Lesezeichen bearbeiten“ ist geöffnet. Im Aufmerksamkeitszustand heben sich die Symbolleistensymbole gut vom schwarzen Hintergrund des Kopfbereichs ab.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind grau mit weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist rot und gedrückt; das Popup „Lesezeichen bearbeiten“ ist geöffnet. Im Aufmerksamkeitszustand heben sich die Symbolleistensymbole gut vom schwarzen Hintergrund des Kopfbereichs ab.

frame

Die Hintergrundfarbe des Kopfbereichs. Sie wird in den Teilen angezeigt, die nicht von den unter "theme_frame" und "additional_backgrounds" angegebenen Einträgen verdeckt werden oder durch diese hindurch sichtbar sind.

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

Firefox 157 und höher (Nova): Firefox ist rot mit weißem Text. Die Tabs sind heller rot, ebenfalls mit weißem Text. Die URL-Leiste ist sehr hellrot mit schwarzem Text.

Firefox 156 und früher: Firefox ist rot mit weißem Text. Die Tabs sind heller rot, ebenfalls mit weißem Text. Die URL-Leiste ist sehr hellrot mit schwarzem Text.

frame_inactive

Die Hintergrundfarbe des Kopfbereichs, wenn das Browserfenster inaktiv ist. Sie wird in den Teilen angezeigt, die nicht von den unter "theme_frame" und "additional_backgrounds" angegebenen Einträgen verdeckt werden oder durch diese hindurch sichtbar sind.

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

Firefox 157 und höher (Nova): Firefox ist grau. Tabs und URL-Leiste sind heller grau. Der Tab-Text ist weiß und die Symbole in der URL-Leiste sind dunkler grau.

Firefox 156 und früher: Firefox ist grau. Tabs und URL-Leiste sind heller grau. Der Tab-Text ist weiß und die Symbole in der URL-Leiste sind dunkler grau.

ntp_background

Die Hintergrundfarbe der Neuer-Tab-Seite.

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

Firefox 157 und höher (Nova): Firefox zeigt eine Neuer-Tab-Seite. Der Hintergrund der Seite ist rot.

Firefox 156 und früher: Firefox zeigt eine Neuer-Tab-Seite. Der Hintergrund der Seite ist rot.

ntp_card_background

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

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

Firefox 157 und höher (Nova): Firefox zeigt eine Neuer-Tab-Seite. Der Hintergrund der Suchleiste und der Verknüpfungsschaltflächen ist rot.

Firefox 156 und früher: Firefox zeigt eine Neuer-Tab-Seite. Der Hintergrund der Suchleiste und der Verknüpfungsschaltflächen ist 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 ansehen
json
"theme": {
  "colors": {
     "ntp_text": "red"
  }
}

Firefox 157 und höher (Nova): Firefox zeigt eine Neuer-Tab-Seite. Der Text auf der Seite ist rot.

Firefox 156 und früher: Firefox zeigt eine Neuer-Tab-Seite. Der Text auf der Seite ist rot.

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

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist blau und gedrückt. Das geöffnete Popup „Lesezeichen bearbeiten“ hat einen roten Hintergrund.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist blau und gedrückt. Das geöffnete Popup „Lesezeichen bearbeiten“ hat einen roten Hintergrund.

popup_border

Die Rahmenfarbe von Popups.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist blau und gedrückt. Das geöffnete Popup „Lesezeichen bearbeiten“ hat einen schwarzen Hintergrund und einen roten Rahmen.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Speichern der Seite als Lesezeichen ist blau und gedrückt. Das geöffnete Popup „Lesezeichen bearbeiten“ hat einen schwarzen Hintergrund und einen roten Rahmen.

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

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

Firefox 157 und höher (Nova): Screenshot eines schwarzen Firefox-Fensters. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen ist geöffnet; der hervorgehobene Eintrag hat einen roten Hintergrund.

Firefox 156 und früher: Screenshot eines schwarzen Firefox-Fensters. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen ist geöffnet; der hervorgehobene Eintrag hat einen roten Hintergrund.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen ist geöffnet. Der hervorgehobene Eintrag hat roten Text auf schwarzem Hintergrund, von dem er sich gut abhebt.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen ist geöffnet. Der hervorgehobene Eintrag hat roten Text auf schwarzem Hintergrund, von dem er sich gut abhebt.

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 höher (Nova) verwendet das Dropdown-Menü der URL-Leiste weder popup noch popup_text. Es behält die Standardfarben des Browsers bei.

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

Firefox 157 und höher (Nova): Firefox mit schwarzem Rahmen und weißem Tab-Text. Das Panel zum Hinzufügen eines Lesezeichens ist geöffnet. Es hat einen schwarzen Hintergrund; Beschriftungen, Felder und Schaltflächen sind rot.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen zeigt rote Eintragstexte, die sich gut vom schwarzen Hintergrund abheben.

sidebar

Die Hintergrundfarbe der Seitenleiste.

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

Firefox 157 und höher (Nova): Nahaufnahme der geöffneten Seitenleiste eines Browserfensters. Der Hintergrund der Seitenleiste ist rot.

Firefox 156 und früher: Nahaufnahme der geöffneten Seitenleiste eines Browserfensters. Der Hintergrund der Seitenleiste ist rot.

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

Firefox 157 und höher (Nova): Nahaufnahme der Firefox-Lesezeichenseitenleiste mit einer roten horizontalen Trennlinie zwischen dem Titel und dem Menü der Seitenleiste. Der Rahmen und die Trennlinie der Seitenleiste sind rot.

Firefox 156 und früher: Nahaufnahme der Firefox-Lesezeichenseitenleiste mit einer roten horizontalen Trennlinie zwischen dem Titel und dem Menü der Seitenleiste. Der Rahmen und die Trennlinie der Seitenleiste sind rot.

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

Firefox 157 und höher (Nova): Lesezeichenseitenleiste mit einer hervorgehobenen Zeile. Statt des vom Theme festgelegten Rots behält die Zeile den standardmäßigen lavendelfarbenen Hintergrund des Browsers bei.

Firefox 156 und früher: Nahaufnahme der Firefox-Lesezeichenseitenleiste mit einem hervorgehobenen Eintrag. Die hervorgehobene Zeile hat einen roten Hintergrund und weißen Text.

sidebar_highlight_text

Die Textfarbe hervorgehobener Zeilen in Seitenleisten.

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

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

Firefox 157 und höher (Nova): Lesezeichenseitenleiste mit einer hervorgehobenen Zeile. Statt des vom Theme festgelegten Rots behält ihre Beschriftung die Standardfarbe des Browsers bei.

Firefox 156 und früher: Nahaufnahme der Firefox-Lesezeichenseitenleiste mit einem hervorgehobenen Eintrag. Der Text der hervorgehobenen Zeile ist rot und hebt sich gut vom rosa Hintergrund ab.

sidebar_text

Die Textfarbe von Seitenleisten.

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

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

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

Firefox 156 und früher: Nahaufnahme der geöffneten Seitenleiste eines Browserfensters. Der Text in der Seitenleiste ist weiß und hebt sich gut vom roten Hintergrund ab.

tab_background_separator

Warnung: tab_background_separator wird seit Firefox 89 nicht mehr unterstützt.

Die Farbe der vertikalen Trennlinie zwischen Hintergrund-Tabs.

Beispiel ansehen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_background_separator": "red"
  }
}

Firefox 157 und höher (Nova): Nahaufnahme von Browser-Tabs, die die Trennlinie hervorhebt.

Firefox 156 und früher: Nahaufnahme von Browser-Tabs, die die Trennlinie hervorhebt.

tab_background_text

Die Farbe des Textes in inaktiven Seiten-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 oder zu frame und frame_inactive bietet.

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind weiß mit roten Symbolen und rotem Text. Der Text im geöffneten Tab ist rot und hebt sich gut vom schwarzen Tab-Hintergrund ab.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind weiß mit roten Symbolen und rotem Text. Der Text im geöffneten Tab ist rot und hebt sich gut vom schwarzen Tab-Hintergrund ab.

tab_line

Die Farbe der Linie am ausgewählten Tab.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tabs und URL-Leiste sind dunkelgrau mit hellgrauen Symbolen und weißem Text. Der ausgewählte Tab hat eine rote Umrandung.

Firefox 156 und früher: Firefox ist schwarz. Tabs und URL-Leiste sind dunkelgrau mit hellgrauen Symbolen und weißem Text. Der ausgewählte Tab hat eine rote Umrandung.

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

Firefox 157 und höher (Nova): Firefox mit schwarzem Rahmen und weißem Tab-Text lädt eine Seite. Die Ladeanzeige im Tab ist standardmäßig grau statt des vom Theme festgelegten Rots.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind dunkelgrau mit weißen Symbolen und weißem Text. Im ausgewählten Tab ist eine rote animierte Ladeanzeige zu sehen.

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Wird diese Eigenschaft nicht verwendet, 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 deutlich erkennbar sind, legen Sie für diese Eigenschaft eine Farbe fest, die sich von frame und frame_inactive abhebt.

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind dunkelgrau mit weißen Symbolen und weißem Text. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind dunkelgrau mit weißen Symbolen und weißem Text. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

tab_text

Ab Firefox 59 bestimmt diese Eigenschaft die Textfarbe des ausgewählten Tabs. Wenn tab_line nicht angegeben ist, bestimmt sie auch die Farbe der Linie am ausgewählten Tab.

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

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

Firefox 157 und höher (Nova): Firefox verwendet ein Theme mit einem Insektenbild. Die URL-Leiste ist hellgrau mit weißen Symbolen. Der Text des ausgewählten Tabs ist rot auf weißem Hintergrund.

Firefox 156 und früher: Firefox verwendet ein Theme mit einem Insektenbild. Die URL-Leiste ist hellgrau mit weißen Symbolen. 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 bestimmt auch die Hintergrundfarbe der Suchleiste.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind rot mit weißem Text und weißen Symbolen. In der Suchleiste sind Text und Symbole dagegen schwarz.

Firefox 156 und früher: Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind rot mit weißem Text und weißen Symbolen. In der Suchleiste sind Text und Symbole dagegen schwarz.

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

Firefox 157 und höher (Nova): Firefox ist schwarz mit weißem Tab-Text; die Seitenleiste zeigt ihre Symbole. Eine rote Linie verläuft entlang des oberen und linken Randes des Webseitenbereichs und trennt ihn von der Symbolleiste darüber und der Seitenleiste links daneben.

Firefox 156 und früher: Firefox ist schwarz. Tab und URL-Leiste sind heller grau mit weißem Text und weißen Symbolen. Eine horizontale rote Linie trennt die Symbolleiste vom darunter angezeigten Webseiteninhalt.

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

Firefox 157 und höher (Nova): Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind heller grau mit weißem Text und weißen Symbolen. Der Hintergrund der URL-Leiste ist rot. Die Suchleiste ist weiß mit schwarzem Text; ihr Suchfeld ist rot mit schwarzem Text.

Firefox 156 und früher: Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind heller grau mit weißem Text und weißen Symbolen. Der Hintergrund der URL-Leiste ist rot. Die Suchleiste ist weiß mit schwarzem Text; ihr Suchfeld ist rot mit schwarzem Text.

toolbar_field_border

Die Rahmenfarbe von Feldern in der Symbolleiste.

Sie bestimmt auch die Rahmenfarbe des Feldes Auf dieser Seite suchen.

Beispiel ansehen
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 höher (Nova): Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die URL-Leiste und das Suchfeld haben eine rote Umrandung.

Firefox 156 und früher: Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die URL-Leiste und das Suchfeld haben eine rote Umrandung.

toolbar_field_border_focus

Die Rahmenfarbe fokussierter Felder in der Symbolleiste.

Beispiel ansehen
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 höher (Nova): Firefox ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Das Feld der URL-Leiste ist fokussiert und rot umrandet.

Firefox 156 und früher: Firefox ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Das Feld der URL-Leiste ist fokussiert und rot umrandet.

toolbar_field_focus

Die Hintergrundfarbe fokussierter Felder in der Symbolleiste, etwa der URL-Leiste.

Beispiel ansehen
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 höher (Nova): Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die fokussierte URL-Leiste hat einen roten Hintergrund und weißen Text.

Firefox 156 und früher: Firefox ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die fokussierte URL-Leiste hat einen roten Hintergrund und weißen Text.

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 ansehen
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 höher (Nova): Firefox ist weiß. Tab und URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und sein Text ist ausgewählt.

Firefox 156 und früher: Firefox ist weiß. Tab und URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und sein 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 dunkles bis mittleres Grün setzt.

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

Beispiel ansehen
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 höher (Nova): Firefox ist weiß. Tab und URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und sein Text ist ausgewählt.

Firefox 156 und früher: Firefox ist weiß. Tab und URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und sein Text ist ausgewählt.

Hier setzt toolbar_field_highlight_text die Textfarbe auf ein dunkles Grün, während die Hervorhebungsfarbe hellgrün ist.

toolbar_field_separator

Warnung: toolbar_field_separator wird seit Firefox 89 nicht mehr unterstützt.

Die Farbe der Trennlinien innerhalb der URL-Leiste. In Firefox 58 wurde dies als toolbar_vertical_separator implementiert.

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Firefox ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Im weißen Feld der URL-Leiste trennt eine rote vertikale Linie nach dem Lesemodus-Symbol die übrigen Symbole ab.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Firefox ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Im weißen Feld der URL-Leiste trennt eine rote vertikale Linie nach dem Lesemodus-Symbol die übrigen Symbole ab.

In diesem Screenshot ist "toolbar_vertical_separator" die rote vertikale Linie in der URL-Leiste, die das Lesemodus-Symbol von den anderen Symbolen trennt.

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

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Der Text in der URL-Leiste ist rot. Auch das Suchfeld zeigt roten Text auf schwarzem Hintergrund.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Der Text in der URL-Leiste ist rot. Auch das Suchfeld zeigt roten Text auf schwarzem Hintergrund.

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

Beispiel ansehen
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 höher (Nova): Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die URL-Leiste ist fokussiert; ihr Text und ihre Symbole sind rot auf schwarzem Hintergrund.

Firefox 156 und früher: Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die URL-Leiste ist fokussiert; ihr Text und ihre Symbole sind rot auf schwarzem Hintergrund.

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

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit rotem Text und roten Symbolen. Der Text im aktiven Tab, in der Navigationsleiste und in der Suchleiste ist rot.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab, Suchleiste und URL-Leiste sind schwarz mit rotem Text und roten Symbolen. 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 ansehen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_top_separator": "red"
  }
}

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Eine rote Linie trennt den oberen Rand der URL-Leiste vom darüberliegenden Browserbereich.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Eine rote Linie trennt den oberen Rand der URL-Leiste 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 URL-Leiste.

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

Firefox 157 und höher (Nova): Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die vertikale Linie, die die Lesezeichen-Symbolleiste vom Inhalt rechts daneben trennt, ist rot.

Firefox 156 und früher: Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Tab und URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die vertikale Linie, die die Lesezeichen-Symbolleiste vom Inhalt rechts daneben trennt, ist rot.

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

Array aus String

Optional

Ein Array aus Aufzählungswerten, das die Ausrichtung des jeweiligen Eintrags im Array "additional_backgrounds": definiert.
Folgende Ausrichtungen sind möglich:

  • "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 additional_backgrounds, werden seine Werte für die fehlenden Einträge erneut verwendet. Wenn additional_backgrounds beispielsweise 5 Werte und additional_backgrounds_alignment die Werte ["left", "top"] enthält, wird der dritte Hintergrundeintrag mit "left", der vierte mit "top" und der fünfte wieder mit "left" ausgerichtet.

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

additional_backgrounds_tiling

Array aus String

Optional

Ein Array aus Aufzählungswerten, das festlegt, wie der jeweilige Eintrag im Array "additional_backgrounds": wiederholt wird. Folgende Werte sind möglich:

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

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

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

additional_backgrounds_size

Array aus String

Optional

Ein Array aus Werten, das die Größe des jeweiligen Eintrags im Array "additional_backgrounds": definiert. Es akzeptiert dieselben Werte wie die CSS-Eigenschaft background-size, beispielsweise "auto", "cover", "contain" oder explizite Werte für Breite und Höhe (etwa "100px 200px").

Enthält das Array weniger Einträge als additional_backgrounds, werden seine Werte für die fehlenden Einträge erneut verwendet. Wenn additional_backgrounds beispielsweise 5 Werte und additional_backgrounds_size die Werte ["auto", "100px 100px"] enthält, wird die Größe des dritten Hintergrundeintrags mit "auto", die des vierten mit "100px 100px" und die des fünften wieder mit "auto" festgelegt.

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

backgrounds_area

String

Optional

Bestimmt den Bereich des Browserfensters, in dem die Hintergrundbilder und Farbverläufe des Themes dargestellt werden. Folgende Werte sind möglich:

  • "auto" – Firefox wählt den Bereich anhand von additional_backgrounds_alignment. Wenn ein Ausrichtungswert einen Hintergrund vertikal in der Mitte oder am unteren Rand des Kopfbereichs positioniert, werden die Hintergründe in den oberen Symbolleisten dargestellt. Andernfalls werden sie im gesamten Fenster dargestellt.
  • "window" – die Hintergründe werden im gesamten Browserfenster dargestellt und erstrecken sich damit auch hinter vertikale Bedienelemente wie die Seitenleiste und vertikale Tabs.
  • "top_toolbars" – die Hintergründe werden nur in den horizontalen Symbolleisten am oberen Fensterrand dargestellt, also in der Menüleiste, der Tab-Leiste, der Navigationsleiste und der Lesezeichen-Symbolleiste. Vertikale Bedienelemente wie die Seitenleiste verwenden stattdessen die Farbe frame.

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

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. Folgende Werte sind möglich:

  • "auto" – ein automatisch anhand des Themes gewähltes helles oder dunkles Farbschema.
  • "light" – ein helles Farbschema.
  • "dark" – ein dunkles Farbschema.
  • "system" – verwendet das Farbschema des Systems.

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

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. Folgende Werte sind möglich:

  • "auto" – ein automatisch anhand des Themes gewähltes helles oder dunkles Farbschema.
  • "light" – ein helles Farbschema.
  • "dark" – ein dunkles Farbschema.
  • "system" – das Farbschema des Systems.

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

Beispiele

Ein einfaches Theme muss ein Bild für den Kopfbereich, die dort zu verwendende Akzentfarbe und die Textfarbe für den Kopfbereich definieren:

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

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. In diesem Fall wird ein einzelnes Bild oben mittig im Kopfbereich verankert und über den restlichen Kopfbereich 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 der 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"
    }
  }

Das Ergebnis sieht so aus:

Firefox 157 und höher (Nova):

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 mit türkisfarbenem Text. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rahmen, grünen Text und eine weiße vertikale Trennlinie. Eine rote Linie trennt die Tabs oben voneinander und eine weiße Linie trennt sie vom darunterliegenden Inhalt.

Firefox 156 und früher:

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 mit türkisfarbenem Text. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rahmen, grünen Text und eine weiße vertikale Trennlinie. Eine rote Linie trennt die Tabs oben voneinander und eine weiße Linie trennt sie vom darunterliegenden Inhalt.

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:

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

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 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_text wird nicht verwendet; verwenden Sie stattdessen colors/bookmark_text.

  • images/theme_frame richtet 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/frame und colors/tab_background_text die Array-Form erforderlich, während für andere Eigenschaften die CSS-Farbform erforderlich war.