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 dieser Schlüssel allein 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 theme-API.

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

properties Object

Optional

Dieses Objekt enthält Eigenschaften, die beeinflussen, wie die Elemente von "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 dürfen nicht auf eine externe URL verweisen.

Bilder sollten 200 Pixel hoch sein, damit sie den Header-Bereich 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 bzw. der dem Header-Bereich 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 Headers aus und wiederholt es, wenn es den Header-Bereich nicht vollständig ausfüllt.

Ab Firefox 60 auf Desktop-Geräten optional.

additional_backgrounds Array aus String oder Object

Warnung: Die Eigenschaft additional_backgrounds ist experimentell. Sie wird in Release-Versionen von Firefox akzeptiert, ihr Verhalten kann sich jedoch ändern.

Ein Array zusätzlicher Hintergründe, bei denen es sich jeweils entweder um den Pfad zu einer in der Erweiterung enthaltenen Bilddatei oder um einen CSS-Farbverlauf handelt. Sie werden dem Header-Bereich hinzugefügt und hinter dem Element "theme_frame": angezeigt. Das erste Element des Arrays liegt dabei ganz oben, das letzte ganz unten. CSS-Farbverläufe werden ab Firefox 153 unterstützt.

Optional

Standardmäßig werden alle Elemente an der oberen rechten Ecke des Header-Bereichs ausgerichtet. Ihre Ausrichtung, ihr Wiederholungsverhalten und ihre 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 Element 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 für die jeweilige CSS-Farbverlaufsfunktion, wie unter CSS-Farbverlaufswerte beschrieben.

colors

Diese Eigenschaften definieren die Farben verschiedener Bereiche des Browsers. Sie sind alle optional. Wie sich diese Eigenschaften auf die Firefox-Benutzeroberfläche auswirken, zeigt die folgende Abbildung:

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

Hinweis: Wenn mehrere Farbeigenschaften eine Komponente beeinflussen, sind die Eigenschaften 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 Lesezeichenleiste und der Suchleiste. Wenn tab_text nicht definiert ist, legt sie auch die Textfarbe des aktiven Tabs fest. Wenn icons nicht definiert ist, legt sie außerdem die Farbe der Symbolleistensymbole fest. Wird als mit Chrome kompatibler Alias für toolbar_text bereitgestellt.

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

Wenn icons nicht definiert ist, achten Sie auch 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 ist schwarz. Der Browser-Tab ist schwarz mit weißem Text. Die URL-Leiste und die Suchleiste sind weiß mit schwarzem Text, aber alle Symbole des Browsers und der Suchleiste sind 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 ist schwarz. Die Tabs und die 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 an, die der Symbolleiste hinzugefügt werden können, darunter die Browser-Bibliothek und die Sidebars.

button_background_hover

Die Hintergrundfarbe von Schaltflächen in der Symbolleiste beim Darüberfahren mit dem Mauszeiger.

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

Firefox ist schwarz. Die Tabs und die URL-Leiste sind grau mit weißem Text. Das Symbol zum Zurücknavigieren ist weiß auf einem 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 anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons": "red"
  }
}

Firefox ist schwarz. Die Tabs und die URL-Leiste sind grau mit weißem Text. Die Symbole der URL-Leiste und zum Öffnen eines neuen Tabs sind rot. Die roten Symbole heben sich gut vom schwarzen Hintergrund des Header-Bereichs ab.

icons_attention

Die Farbe von Symbolleistensymbolen im Aufmerksamkeitszustand, etwa des Sternsymbols für Lesezeichen 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 anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons_attention": "red"
  }
}

Firefox ist schwarz. Die Tabs und die URL-Leiste sind grau mit weißem Text. Das Symbol zum Setzen eines Lesezeichens für diese Seite ist rot und gedrückt; ein Popup zum Bearbeiten des Lesezeichens ist geöffnet. Im Aufmerksamkeitszustand heben sich die Symbolleistensymbole gut vom schwarzen Hintergrund des Header-Bereichs ab.

frame

Die Hintergrundfarbe des Header-Bereichs. Sie wird in den Teilen des Headers angezeigt, die nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen bedeckt sind oder durch diese hindurch sichtbar bleiben.

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

Firefox ist rot mit weißem Text. Die Browser-Tabs sind heller rot, ebenfalls mit weißem Text. Die URL-Leiste ist sehr hellrot mit schwarzem Text.

frame_inactive

Die Hintergrundfarbe des Header-Bereichs, wenn das Browserfenster inaktiv ist. Sie wird in den Teilen des Headers angezeigt, die nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen bedeckt sind oder durch diese hindurch sichtbar bleiben.

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

Firefox ist grau. Die Tabs und die URL-Leiste sind heller grau. Der Tab-Text ist weiß und die Symbole der URL-Leiste sind dunkler grau.

ntp_background

Die Hintergrundfarbe der Seite „Neuer Tab“.

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

Firefox zeigt eine Seite „Neuer Tab“ mit rotem Hintergrund.

ntp_card_background

Die Hintergrundfarbe der Karten auf der Seite „Neuer Tab“.

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

Firefox zeigt eine Seite „Neuer Tab“. Die Hintergründe der Suchleiste und der Verknüpfungsschaltflächen auf der Seite sind rot.

ntp_text

Die Textfarbe der Seite „Neuer Tab“.

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

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

Firefox zeigt eine Seite „Neuer Tab“. Der Text auf der Seite ist rot.

popup

Die Hintergrundfarbe von Popups, beispielsweise des Dropdown-Menüs der URL-Leiste und der Pfeil-Panels.

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

Firefox ist schwarz. Die Tabs und die URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Setzen eines Lesezeichens für diese Seite ist blau und gedrückt. Ein Popup zum Bearbeiten des Lesezeichens mit rotem Hintergrund ist geöffnet.

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 ist schwarz. Die Tabs und die URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Das Symbol zum Setzen eines Lesezeichens für diese Seite ist blau und gedrückt. Ein Popup zum Bearbeiten des Lesezeichens mit schwarzem Hintergrund und rotem Rahmen ist geöffnet.

popup_highlight

Die Hintergrundfarbe von Elementen, die innerhalb von Popups per Tastatur hervorgehoben werden, beispielsweise 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 anzeigen
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup_highlight": "red",
     "popup_highlight_text": "white"
  }
}

Screenshot von Firefox mit schwarzem Browserfenster. Die Tabs und die URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. Ein Popup mit Suchergebnissen wird angezeigt; der Hintergrund eines hervorgehobenen Eintrags ist rot.

popup_highlight_text

Die Textfarbe hervorgehobener Elemente innerhalb von 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 ist schwarz. Die Tabs und die URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. In einem Popup mit Suchergebnissen hat ein hervorgehobener Eintrag roten Text auf schwarzem Hintergrund. Der Text hebt sich gut vom Hintergrund des Eintrags ab.

popup_text

Die Textfarbe von Popups.

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

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

Firefox ist schwarz. Die Tabs und die URL-Leiste sind heller grau mit weißen Symbolen und weißem Text. In einem Popup mit Suchergebnissen ist der Text der Einträge rot und hebt sich gut vom schwarzen Hintergrund des Popups ab.

sidebar

Die Hintergrundfarbe der Sidebar.

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

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.

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

Nahaufnahme der Lesezeichen-Sidebar von Firefox mit einer roten horizontalen Trennlinie zwischen dem Titel der Sidebar und ihrem Menü. Die Rahmen- und Trennlinienfarbe der Sidebar ist rot.

sidebar_highlight

Die Hintergrundfarbe hervorgehobener Zeilen in integrierten Sidebars.

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

Nahaufnahme der Lesezeichen-Sidebar von 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.

Beispiel anzeigen
json
"theme": {
  "colors": {
    "sidebar_highlight": "pink",
    "sidebar_highlight_text": "red",
  }
}

Nahaufnahme der Lesezeichen-Sidebar von Firefox mit einem hervorgehobenen Eintrag. Der Text der hervorgehobenen Zeile ist rot und hebt sich gut vom rosafarbenen 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"
  }
}

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

tab_background_separator

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

Die Farbe der vertikalen Trennlinie zwischen inaktiven Tabs.

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

Nahaufnahme von Browser-Tabs, die die Trennlinie hervorhebt.

tab_background_text

Die Textfarbe in inaktiven Tabs. Wenn tab_text und bookmark_text nicht angegeben sind, 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"
  }
}

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste sind weiß mit roten Symbolen und rotem 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 ist schwarz. Die Tabs und die 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 des Tabs.

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

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste sind dunkelgrau mit weißen Symbolen und weißem Text. Im ausgewählten Tab ist die animierte Ladeanzeige rot.

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.

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

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die 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 definiert diese Eigenschaft die Textfarbe des ausgewählten Tabs. Wenn tab_line nicht angegeben ist, bestimmt sie auch 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"
  }
}

Das Firefox-Theme zeigt ein Insekt. 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 legt auch die Hintergrundfarbe der Suchleiste fest.

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

Firefox ist schwarz. Der Tab, die Suchleiste und die 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, die den unteren Rand der Symbolleiste vom darunterliegenden Bereich trennt.

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

Firefox ist schwarz. Der Tab und die URL-Leiste sind heller grau mit weißem Text und weißen Symbolen. Eine horizontale rote Linie trennt den unteren Rand der Symbolleiste vom darunter angezeigten Webseiteninhalt.

toolbar_field

Die Hintergrundfarbe von Feldern in der Symbolleiste, beispielsweise der URL-Leiste.

Sie legt auch die Hintergrundfarbe des Felds Auf dieser Seite suchen fest.

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

Firefox ist schwarz. Der Tab, die Suchleiste und die URL-Leiste sind heller grau mit weißem Text und weißen Symbolen. Das Feld der URL-Leiste hat einen roten Hintergrund. 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 legt auch die Rahmenfarbe des Felds Auf dieser 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 ist schwarz. Der Tab, die Suchleiste und die URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die Felder der URL-Leiste und der Suchleiste sind rot umrandet.

toolbar_field_border_focus

Die Rahmenfarbe fokussierter Felder in der Symbolleiste.

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 ist schwarz. Der Tab und die 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, beispielsweise der URL-Leiste.

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 ist schwarz. Der Tab, die Suchleiste und die URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Der Hintergrund der fokussierten URL-Leiste ist rot und ihr Text ist weiß.

toolbar_field_highlight Die Hintergrundfarbe, mit der aktuell ausgewählter Text in der URL-Leiste markiert wird (und in der Suchleiste, falls diese als separates Feld konfiguriert ist).
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 ist weiß. Der Tab und die URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und der Text darin ist ausgewählt.

Hier legt das Feld toolbar_field_highlight ein helles Grün als Markierungsfarbe fest, während toolbar_field_highlight_text die Textfarbe auf ein mittleres bis dunkles Grün setzt.

toolbar_field_highlight_text

Die Farbe von aktuell ausgewähltem Text 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 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 ist weiß. Der Tab und die URL-Leiste sind weiß mit schwarzem Text und schwarzen Symbolen. Das Feld der URL-Leiste ist fokussiert, blau umrandet und der Text darin ist ausgewählt.

Hier setzt das Feld toolbar_field_highlight_text die Textfarbe auf ein mittleres bis dunkles Grün, während die Markierungsfarbe hellgrün ist.

toolbar_field_separator

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

Die Farbe von Trennlinien innerhalb der URL-Leiste. In Firefox 58 wurde dies über toolbar_vertical_separator umgesetzt.

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

Screenshot eines Browserfensters mit einem geöffneten Tab. Firefox ist schwarz. Der Tab und die URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Innerhalb des weißen Felds der URL-Leiste trennt eine rote vertikale Linie hinter dem Symbol für den Lesemodus die übrigen Symbole ab.

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

toolbar_field_text

Die Textfarbe in Feldern der Symbolleiste, beispielsweise in der URL-Leiste. Sie legt auch die Textfarbe im Feld Auf dieser 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"
  }
}

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Der Text in der URL-Leiste ist rot. Auch das Suchfeld hat roten Text auf schwarzem Hintergrund.

toolbar_field_text_focus

Die Textfarbe in fokussierten Feldern der Symbolleiste, beispielsweise in der URL-Leiste.

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"
  }
}

Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Der Tab und die URL-Leiste sind schwarz mit weißem Text und weißen Symbolen. Die URL-Leiste ist fokussiert; Text und Symbole darin sind rot auf schwarzem Hintergrund.

toolbar_text

Die Textfarbe der Symbolleiste. Sie legt auch 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"
  }
}

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab, die Suchleiste und die 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 anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_top_separator": "red"
  }
}

Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Der Tab und die 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 von Trennlinien innerhalb der URL-Leiste.

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

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

Aliase

Dieser Schlüssel akzeptiert außerdem verschiedene Eigenschaften als Aliase für die oben aufgeführten Eigenschaften. Sie dienen der Kompatibilität mit Chrome. Wenn sowohl ein Alias als auch die zugehörige Eigenschaft angegeben werden, wird der Wert der Eigenschaft und nicht der des Alias verwendet.

Name Alias für
bookmark_text toolbar_text

properties

Name Typ Beschreibung
additional_backgrounds_alignment

Array aus String-Werten

Optional

Ein Array von Aufzählungswerten, die die Ausrichtung des jeweiligen Elements im Array "additional_backgrounds": festlegen.
Mögliche Werte 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 Elemente 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 den Wert ["left", "top"], wird der dritte Hintergrund mit "left", der vierte mit "top" und der fünfte wieder mit "left" ausgerichtet.

Ohne Angabe gilt standardmäßig "right top".

additional_backgrounds_tiling

Array aus String-Werten

Optional

Ein Array von Aufzählungswerten, die festlegen, wie das jeweilige Element im Array "additional_backgrounds": wiederholt wird. Mögliche Werte sind:

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

Enthält das Array weniger Elemente 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 den Wert ["no-repeat", "repeat-x"], wird für den dritten Hintergrund "no-repeat", für den vierten "repeat-x" und für den fünften wieder "no-repeat" verwendet.

Ohne Angabe gilt standardmäßig "no-repeat".

additional_backgrounds_size

Array aus String-Werten

Optional

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

Enthält das Array weniger Elemente 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 den Wert ["auto", "100px 100px"], erhält der dritte Hintergrund die Größe "auto", der vierte "100px 100px" und der fünfte wieder "auto".

Ohne Angabe gilt standardmäßig "auto".

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 am unteren Rand des Header-Bereichs positioniert, werden die Hintergründe in den oberen Symbolleisten gezeichnet. Andernfalls werden sie im gesamten Fenster gezeichnet.
  • "window" – die Hintergründe werden im gesamten Browserfenster gezeichnet, sodass sie sich auch hinter vertikalen Elementen der Benutzeroberfläche wie der Sidebar und vertikalen Tabs erstrecken.
  • "top_toolbars" – die Hintergründe werden nur in den horizontalen Symbolleisten am oberen Fensterrand gezeichnet, also in der Menüleiste, der Tableiste, der Navigationsleiste und der Lesezeichen-Symbolleiste. Vertikale Elemente der Benutzeroberfläche wie die Sidebar verwenden stattdessen die Farbe frame.

Ohne Angabe gilt standardmäßig "auto".

color_scheme

String

Optional

Bestimmt, welches Farbschema auf die Browseroberfläche (beispielsweise Kontextmenüs) und Inhalte (beispielsweise integrierte Seiten und das bevorzugte Farbschema für Webseiten) angewendet wird. Mögliche Werte sind:

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

Ohne Angabe gilt standardmäßig "auto".

content_color_scheme

String

Optional

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

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

Ohne Angabe gilt standardmäßig "auto".

Beispiele

Ein einfaches Theme muss ein Bild für den Header, eine Akzentfarbe für den Header und eine Farbe für den dort angezeigten Text definieren:

json
 "theme": {
   "images": {
     "theme_frame": "images/sun.jpg"
   },
   "colors": {
     "frame": "#CF723F",
     "tab_background_text": "black"
   }
 }

Der Header kann mit mehreren Elementen gefüllt werden. Verwenden Sie vor Firefox 60 ein leeres oder transparentes Header-Bild, um die Position der einzelnen zusätzlichen Elemente 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 Header auch mit einem oder mehreren wiederholten Bildern füllen. Im folgenden Fall wird ein einzelnes Bild oben mittig im Header ausgerichtet und über den restlichen Header 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"
    }
  }

Damit erhalten Sie einen Browser, der so aussieht:

Ein Browserfenster mit zwei geöffneten Tabs und einem dunkelgrünen Hintergrund im Header-Bereich. 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 am oberen Rand, und eine weiße Linie trennt die Tabs vom darunterliegenden Inhalt.

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der URL-Leiste, die das Symbol für den Lesemodus von den anderen Symbolen trennt.

Dieses Beispiel (Firefox 153+) 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 wird von oben rechts aus angezeigt, horizontal über den Header wiederholt (repeat-x) und auf eine Höhe von 144px skaliert (die Breite wird automatisch bestimmt). Der Farbverlauf geht oben von Rosa (#FF6BBA) nach unten zu Pfirsichfarben (#FFC999) über.

Dieses Beispiel (Firefox 156+) beschränkt den Hintergrundfarbverlauf auf die horizontalen Symbolleisten am oberen Fensterrand, sodass er sich nicht hinter die Sidebar oder vertikale Tabs erstreckt. Ohne backgrounds_area bewirkt die Ausrichtung "right top", 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. Wenn Sie backgrounds_area stattdessen auf "window" setzen, wird der Farbverlauf im gesamten Fenster gezeichnet, auch 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 richtet das Bild an der oberen linken Ecke des Headers aus und wiederholt es, wenn es den Header-Bereich 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 CSS-Farbwerte akzeptiert. Davor erforderten colors/frame und colors/tab_background_text die Array-Form, während andere Eigenschaften CSS-Farbwerte erforderten.