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
Verpflichtend 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 theme-Schlüssel, um ein statisches Thema für Firefox zu definieren. Wenn es alleine angegeben wird, definiert es das Thema, das verwendet wird, wenn Firefox entweder das helle oder dunkle Farbschema verwendet. Wenn der dark_theme-Schlüssel angegeben wird, bietet dieser Schlüssel das Thema, das verwendet wird, wenn Firefox das helle Farbschema verwendet.

Hinweis: Wenn Sie ein Thema mit einer Erweiterung einschließen möchten, sehen Sie bitte die theme API.

Hinweis: Seit Mai 2019 müssen Themes signiert sein, um installiert werden zu können (Firefox Bug 1545109). Weitere Informationen finden Sie unter Signing and distributing your add-on.

Bildformate

Die folgenden Bildformate werden in allen Themenbildeigenschaften unterstützt:

  • JPEG
  • PNG
  • APNG
  • SVG (animiertes SVG wird ab Firefox 59 unterstützt)
  • GIF (animiertes GIF wird nicht unterstützt)

Syntax

Der theme-Schlüssel ist ein Objekt, das die folgenden Eigenschaften aufnimmt:

Name Typ Beschreibung
images Object

Optional ab Firefox 60. Vor Firefox 60 erforderlich.

Ein JSON-Objekt, dessen Eigenschaften die Bilder darstellen, die in verschiedenen Teilen des Browsers angezeigt werden sollen. Siehe images für Details zu den Eigenschaften, die dieses Objekt enthalten kann.

colors Object

Verpflichtend

Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener Teile des Browsers darstellen. Siehe colors für Details zu den Eigenschaften, die dieses Objekt enthalten kann.

properties Object

Optional

Dieses Objekt hat Eigenschaften, die beeinflussen, wie die "additional_backgrounds"-Elemente angezeigt und Farbpaletten angewendet werden. Siehe properties für Details zu den Eigenschaften, die dieses Objekt enthalten kann.

images

Alle URLs sind relativ zur manifest.json-Datei und können keine externe URL referenzieren.

Bilder sollten 200 Pixel hoch sein, um sicherzustellen, dass sie den Kopfbereich immer vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String oder Object

Ein Vordergrundbild (definiert durch den Pfad zu einer im Add-on enthaltenen Bilddatei) oder ein CSS-Gradient zum Hinzufügen zum Kopfbereich, verankert an der oberen rechten Ecke des Kopfbereichs. CSS-Gradienten werden ab Firefox 153 unterstützt.

Hinweis: Chrome verankert das Bild oben links im Kopfbereich und wenn das Bild den Kopfbereich nicht ausfüllt, wird es gekachelt.

Optional im Desktop Firefox 60 und später.

additional_backgrounds Array von String oder Object

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

Ein Array zusätzlicher Hintergrundelemente, die jeweils entweder der Pfad zu einer im Add-on enthaltenen Bilddatei oder ein CSS-Gradient sein können, der zum Kopfbereich hinzugefügt und hinter dem "theme_frame":-Element angezeigt wird. Diese zusätzlichen Hintergrundelemente schichten das erste Element im Array oben und das letzte Element unten. CSS-Gradienten werden ab Firefox 153 unterstützt.

Optional

Standardmäßig sind alle Elemente an der oberen rechten Ecke des Kopfbereichs verankert, aber ihre Ausrichtung, Wiederholung und Größenverhalten können durch "properties": gesteuert werden.

Da zusätzliche Hintergrundelemente hinter dem theme_frame-Element angezeigt werden, werden zusätzliche Hintergrundelemente versteckt, wenn theme_frame als CSS-Gradient festgelegt ist.

CSS-Gradient-Syntax

Ein CSS-Gradient wird als Objekt in der Form { "GRADIENT_TYPE": "GRADIENT_PARAMS" } angegeben, wobei:

  • GRADIENT_TYPE eines der folgenden ist:
    • linear-gradient
    • radial-gradient
    • conic-gradient
    • repeating-linear-gradient
    • repeating-radial-gradient
    • repeating-conic-gradient
  • GRADIENT_PARAMS die Parameter für die CSS-Gradient-Funktion enthält, wie in CSS-Gradient-Werte beschrieben.

colors

Diese Eigenschaften definieren die Farben, die für verschiedene Teile des Browsers verwendet werden. Sie sind alle optional. Wie diese Eigenschaften die Firefox-Benutzeroberfläche beeinflussen, wird hier gezeigt:

Übersicht über die Farbeigenschaften und wie sie auf die Firefox-Benutzeroberfläche angewendet werden

Hinweis: Wenn ein Element von mehreren Farbeigenschaften beeinflusst wird, sind die Eigenschaften nach Priorität aufgelistet.

Alle diese Eigenschaften können entweder als String angegeben werden, der einen beliebigen gültigen CSS-Farbstring (einschließlich hexadezimal) enthält, oder als RGB-Array, wie etwa "tab_background_text": [ 107 , 99 , 23 ].

Name Beschreibung
bookmark_text

Die Farbe von Text und Symbolen in der Lesezeichen- und Suchleiste. Auch, wenn tab_text nicht definiert ist, wird die Farbe des aktiven Tab-Textes und wenn icons nicht definiert ist, die Farbe der Symbolleiste-Symbole festgelegt. Wird als Chrome-kompatibles Alias für toolbar_text bereitgestellt.

Hinweis: Stellen Sie sicher, dass jede verwendete Farbe gut mit den in frame und frame_inactive oder toolbar verwendeten Farben kontrastiert, wenn Sie diese Eigenschaft verwenden.

Wenn icons nicht definiert ist, stellen Sie auch sicher, dass ein guter Kontrast zu button_background_active und button_background_hover besteht.

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

Browser Firefox ist schwarz. Der Tab des Browsers ist schwarz mit weißem Text. Die URL-Leiste und die Suchleiste sind weiß mit schwarzem Text, aber alle Symbolleiten- und Suchleisten-Icons sind rot.

button_background_active

Die Hintergrundfarbe der gedrückten Symbolleistenschaltflächen.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind grau mit weißem Text. Das Symbol für die Symbolleiste im URL-Bereich ist weiß mit rotem Hintergrund und wird gedrückt. Ein Popup wird angezeigt, das eine kurze Liste von Elementen enthält, die zur Symbolleiste hinzugefügt werden können, wie die Bibliothek des Browsers und die Seitenleisten.

button_background_hover

Die Hintergrundfarbe der Symbolleistenschaltflächen bei Hover.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind grau mit weißem Text. Das Zurück-Symbol ist weiß mit einem roten Kreis-Hintergrund.

icons

Die Farbe der Symbolleistensymbole, mit Ausnahme derjenigen in der Suchleiste.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in frame, frame_inactive, button_background_active und button_background_hover verwendeten Farben kontrastiert.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind grau mit weißem Text. Das URL-Leisten- und Neues-Tab-Icons sind rot. Die roten Symbole kontrastieren gut mit dem schwarzen Hintergrund des Kopfbereichs.

icons_attention

Die Farbe der Symbolleistensymbole im Aufmerksamkeitsmodus, wie das mit Stern markierte Lesezeichen-Symbol oder das Fertig-Download-Symbol.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in frame, frame_inactive, button_background_active und button_background_hover verwendeten Farben kontrastiert.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind grau mit weißem Text. Das Bookmark-this-Page-Symbol ist rot und gedrückt, ein geöffnetes Popup mit Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt. Während im Aufmerksamkeitszustand die Symbolleistensymbole gut mit dem schwarzen Hintergrund des Kopfbereichs kontrastieren.

frame

Die Farbe des Hintergrunds im Kopfbereich, angezeigt in dem Teil des Kopfbereichs, der nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen bedeckt oder sichtbar ist.

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

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

frame_inactive

Die Farbe des Hintergrunds im Kopfbereich, wenn das Browserfenster inaktiv ist. Wird in dem Teil des Kopfbereichs angezeigt, der nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen bedeckt oder sichtbar ist.

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

Browser Firefox ist grau. Die Tabs und die URL-Leiste des Browsers sind heller grau. Der Tab-Text ist weiß und die URL-Leistensymbole sind dunkler grau.

ntp_background

Die Hintergrundfarbe der neuen Tab-Seite.

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

Firefox zeigt eine neue Tab-Seite an. Der Hintergrund der Seite ist rot.

ntp_card_background

Die Hintergrundfarbe der Karten auf der neuen Tab-Seite.

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

Firefox zeigt eine neue Tab-Seite an. Auf der Seite ist der Hintergrund der Suchleiste und der Schnellzugriffsschaltflächen rot.

ntp_text

Die Textfarbe auf der neuen Tab-Seite.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit der in ntp_background und ntp_card_background verwendeten Farbe kontrastiert.

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

Firefox zeigt eine neue Tab-Seite an. Auf der Seite ist der Text rot.

popup

Die Hintergrundfarbe von Pop-ups (wie das Dropdown-Menü der URL-Leiste und die Pfeilfenster).

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Das Symbol 'Seite als Lesezeichen markieren' ist blau und gedrückt, ein geöffnetes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt, und der Hintergrund ist rot. Die Hintergrundfarbe des Pop-ups ist rot.

popup_border

Die Rahmenfarbe von Pop-ups.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Das Symbol 'Seite als Lesezeichen markieren' ist blau und gedrückt, ein geöffnetes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt, und der Rand ist rot.

popup_highlight

Die Hintergrundfarbe von Elementen, die mit der Tastatur in Pop-ups hervorgehoben sind (wie dem ausgewählten Element im Dropdown-Menü der URL-Leiste).

Hinweis: Es wird empfohlen, popup_highlight_text zu definieren, um die Standardfarbe 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"
  }
}

Ein Screenshot von Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Ein Pop-up-Fenster mit Suchergebnissen wird angezeigt, mit einem hervorgehobenen Element, dessen Hintergrund rot ist. Die Hintergrundfarbe des hervorgehobenen Elements im Pop-up ist rot.

popup_highlight_text

Die Textfarbe der in Pop-ups hervorgehobenen Elemente.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit der in popup_highlight verwendeten Farbe kontrastiert.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Ein Suchergebnis-Popup wird angezeigt, mit einem hervorgehobenen Element, dessen Text rot ist und einen schwarzen Hintergrund hat. Die Textfarbe des hervorgehobenen Elements kontrastiert gut mit der schwarzen Hintergrundfarbe dieses Elements.

popup_text

Die Textfarbe von Pop-ups.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit der in popup verwendeten Farbe kontrastiert.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Ein Suchergebnis-Popup wird angezeigt, dessen Texte rot sind. Die Textfarbe kontrastiert gut mit der schwarzen Hintergrundfarbe des Pop-ups.

sidebar

Die Hintergrundfarbe der Seitenleiste.

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

Ein Nahaufnahme-Screenshot der geöffneten Seitenleiste eines Browserfensters. Die Hintergrundfarbe der Seitenleiste ist rot.

sidebar_border

Die Rahmen- und Trennlinie der Browser-Seitenleiste

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

Ein Nahaufnahme der Lesezeichen-Seitenleiste im Firefox-Browser mit einem roten horizontalen Trennstrich zwischen dem Titel der Seitenleiste und dem Menü der Seitenleiste. Die Rahmen- und Trennlinienfarbe der Seitenleiste ist rot.

sidebar_highlight

Die Hintergrundfarbe hervorgehobener Zeilen in den eingebauten Seitenleisten

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

Ein Nahaufnahme der Lesezeichen-Seitenleiste im Firefox-Browser mit einem hervorgehobenen Element. Die Hintergrundfarbe einer hervorgehobenen Zeile in der Seitenleiste ist rot mit weißem Text.

sidebar_highlight_text

Die Textfarbe hervorgehobener Zeilen in den Seitenleisten.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit der in sidebar_highlight verwendeten Farbe kontrastiert.

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

Ein Nahaufnahme der Lesezeichen-Seitenleiste im Firefox-Browser mit einem hervorgehobenen Element. Die Farbe des Textes einer hervorgehobenen Zeile in der Seitenleiste ist rot. Die Textfarbe kontrastiert gut mit der rosa Hintergrundfarbe der hervorgehobenen Zeile.

sidebar_text

Die Textfarbe der Seitenleisten.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit der in sidebar verwendeten Farbe kontrastiert.

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

Ein Nahaufnahme-Screenshot der geöffneten Seitenleiste eines Browserfensters. Die Farbe des Textes in der Seitenleiste ist weiß. Die Textfarbe kontrastiert gut mit dem roten Hintergrund der Seitenleiste.

tab_background_separator

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

Die Farbe des vertikalen Trenners der Hintergrund-Tabs.

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

Ein Nahaufnahme der Browsing-Tabs zur Hervorhebung des Trenners.

tab_background_text

Die Farbe des Textes, der in den inaktiven Seiten-Tabs angezeigt wird. Wenn tab_text oder bookmark_text nicht angegeben ist, gilt dies für den Text im aktiven Tab.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in tab_selected oder frame und frame_inactive verwendeten Farben kontrastiert.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind weiß mit roten Symbolen und rotem Text. Die Farbe des Textes im geöffneten Tab ist rot. Die Textfarbe kontrastiert gut mit der schwarzen Hintergrundfarbe des Tabs.

tab_line

Die Farbe der Linie im ausgewählten Tab.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind dunkler grau mit helleren grauen Symbolen und weißem Text. Der ausgewählte Tab hat eine rote Umrandung.

tab_loading

Die Farbe des Ladeindikators und des Ladebursts im Tab.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind dunkler grau mit Symbolen und Text in weiß. Im ausgewählten Tab ist ein animierter Ladeindikator rot.

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Wenn nicht in Gebrauch, wird die Farbe des ausgewählten Tabs durch frame und frame_inactive festgelegt.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind dunkler grau mit Symbolen und Text in weiß. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

tab_text

Ab Firefox 59 repräsentiert es die Textfarbe für den ausgewählten Tab. Wenn tab_line nicht angegeben ist, definiert es auch die Farbe der ausgewählten Tab-Linie.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in tab_selected oder frame und frame_inactive verwendeten Farben kontrastiert.

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

Browser Firefox hat ein Insektenthema. Die URL-Leiste ist heller grau mit weißen Symbolen. Der ausgewählte Tab-Text ist rot mit weißem Hintergrund.

toolbar

Die Hintergrundfarbe für die Navigationsleiste, die Lesezeichenleiste und den ausgewählten Tab.

Dies legt auch die Hintergrundfarbe der "Find"-Leiste fest.

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

Browser Firefox ist schwarz. Die Tabs, die Suchleiste und die URL-Leiste im Browser sind rot mit weißem Text und Symbolen, außer in der Suchleiste, wo Text und Symbol schwarz sind.

toolbar_bottom_separator

Die Farbe der Linie, die den unteren Teil der Symbolleiste von der Region darunter trennt.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste im Browser sind dunkler grau mit weißem Text und Symbolen. Eine horizontale rote Linie trennt den unteren Teil der Symbolleiste vom Beginn der Anzeige der Webseite.

toolbar_field

Die Hintergrundfarbe für Felder in der Symbolleiste, wie die URL-Leiste.

Dies legt auch die Hintergrundfarbe des Suchfeldes fest.

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

Browser Firefox ist schwarz. Die Tabs, die Suchleiste und die URL-Leiste im Browser sind heller grau mit weißen Symbolen und Text. Die Hintergrundfarbe der URL-Leiste ist rot. Die Suchleiste ist weiß mit schwarzem Text. Das Suchfeld ist rot mit schwarzem Text.

toolbar_field_border

Die Rahmenfarbe für Felder in der Symbolleiste.

Dies legt auch die Rahmenfarbe des Suchfeldes 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"
  }
}

Browser Firefox ist schwarz. Die Tabs, die Suchleiste und die URL-Leiste im Browser sind schwarz mit weißen Symbolen und Text. Die URL-Leiste und die Suchfeld sind rot umrandet.

toolbar_field_border_focus

Die fokussierte Rahmenfarbe für 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"
  }
}

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste im Browser sind schwarz mit weißen Symbolen und Text. Die URL-Leiste ist fokussiert und rot umrandet.

toolbar_field_focus

Die fokussierte Hintergrundfarbe für Felder in der Symbolleiste, wie die 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"
  }
}

Browser Firefox ist schwarz. Die Tabs, die Suchleiste und die URL-Leiste im Browser sind schwarz mit weißen Symbolen und Text. Die Hintergrundfarbe der fokussierten URL-Leiste ist rot und der Text ist weiß.

toolbar_field_highlight Die Hintergrundfarbe, die die aktuelle Textauswahl in der URL-Leiste (und der Suchleiste, wenn konfiguriert) kennzeichnet.
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)"
  }
}

Browser Firefox ist weiß. Die Tabs und die URL-Leiste des Browsers sind weiß mit Texten und Symbolen in schwarz. Der URL-Leistenbereich ist fokussiert und blau umrandet, und der Text in der URL-Leiste ist ausgewählt.

Hier gibt das toolbar_field_highlight-Feld an, dass die Hervorhebungsfarbe hellgrün ist, während der Text ist auf einen mittel-dunklen Grün gesetzt mit toolbar_field_highlight_text.

toolbar_field_highlight_text

Die Farbe, die verwendet wird, um den aktuell ausgewählten Text in der URL-Leiste (und der Suchleiste, wenn sie als separates Feld konfiguriert ist) darzustellen.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in toolbar_field_highlight verwendeten Farben kontrastiert.

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

Browser Firefox ist weiß. Die Tabs und die URL-Leiste des Browsers sind weiß mit Texten und Symbolen in schwarz. Der URL-Leistenbereich ist fokussiert und blau umrandet, und der Text in der URL-Leiste ist ausgewählt.

Hier wird das toolbar_field_highlight_text-Feld verwendet, um die Textfarbe auf ein dunkles mittleres Grün zu setzen, während die Hervorhebungsfarbe hellgrün ist.

toolbar_field_separator

Warnung: toolbar_field_separator wird ab 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 anzeigen
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field_separator": "red"
  }
}

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind schwarz mit Texten und Symbolen in weiß. Innerhalb des weißen URL-Leistenbereichs, nach dem Leseansichts-Symbol, eine rote vertikale Linie, die den Rest der URL-Leistensymbole trennt. Die Trennlinie innerhalb der URL-Leiste ist rot.

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

toolbar_field_text

Die Farbe des Textes in Feldern in der Symbolleiste, wie der URL-Leiste. Dies setzt auch die Farbe des Textes im Suchfeld fest.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in toolbar_field verwendeten Farben kontrastiert.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Der Text innerhalb der URL-Leiste ist rot. Die Symbole und das Suchfeld haben roten Text auf schwarzem Hintergrund.

toolbar_field_text_focus

Die Farbe des Textes in fokussierten Feldern in der Symbolleiste, wie der URL-Leiste.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit denen in toolbar_field_focus verwendeten Farben kontrastiert.

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

Ein Screenshot eines Browserfensters mit zwei geöffneten Tabs. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Die URL-Leiste hat den Fokus; der Text und die Symbole der Leiste sind rot auf schwarzem Hintergrund.

toolbar_text

Die Farbe des Toolbar-Textes. Dies setzt auch die Farbe des Textes in der "Find"-Leiste fest.

Hinweis: Zur Kompatibilität mit Chrome verwenden Sie das Alias bookmark_text.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs, die Suchleiste und die URL-Leiste im Browser sind schwarz mit rotem Text und Symbolen. Der Text innerhalb des aktiven Tabs, der Navigationsleiste und der Suchleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die die obere Seite der Symbolleiste von der Region darüber trennt.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Eine rote Linie trennt die Oberseite der URL-Leiste vom Browser.

toolbar_vertical_separator

Die Farbe des Trenners in der Lesezeichen-Symbolleiste. In Firefox 58 entspricht dies der Farbe der Trennlinien in der URL-Leiste.

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Die Farbe der vertikalen Linie, die die Lesezeichen-Symbolleiste von dem Inhalt rechts trennt, ist rot.

Aliase

Zusätzlich akzeptiert dieser Schlüssel verschiedene Eigenschaften, die Aliase für eine der oben genannten Eigenschaften sind. Diese werden zur Kompatibilität mit Chrome bereitgestellt. Wenn ein Alias angegeben ist und die Nicht-Alias-Version ebenfalls angegeben ist, wird der Wert aus der Nicht-Alias-Version übernommen.

Name Alias für
bookmark_text toolbar_text

properties

Name Typ Beschreibung
additional_backgrounds_alignment

Array von String

Optional

Ein Array von Enumerationswerten, die die Ausrichtung des entsprechenden "additional_backgrounds":-Array-Elements definieren.
Die Ausrichtungsoptionen umfassen:

  • "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 additional_backgrounds-Array, wird das Array für die fehlenden Werte wiederverwendet. Wenn beispielsweise additional_backgrounds 5 Werte enthält und additional_backgrounds_alignment ["left", "top"] enthält, wird das dritte Hintergrundelement mit "left" ausgerichtet, das vierte mit "top" und das fünfte "left".

Wenn nicht angegeben, ist "right top" der Standardwert.

additional_backgrounds_tiling

Array von String

Optional

Ein Array von Enumerationswerten, die definieren, wie das entsprechende "additional_backgrounds":-Array-Element wiederholt wird. Optionen umfassen:

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

Enthält das Array weniger Elemente als das additional_backgrounds-Array, wird das Array für die fehlenden Werte wiederverwendet. Wenn beispielsweise additional_backgrounds 5 Werte enthält und additional_backgrounds_tiling ["no-repeat", "repeat-x"] enthält, wird das dritte Hintergrundelement mit "no-repeat" gekachelt, das vierte mit "repeat-x" und das fünfte "no-repeat".

Wenn nicht angegeben, ist "no-repeat" der Standardwert.

additional_backgrounds_size

Array von String

Optional

Ein Array von Werten, die die Größe des entsprechenden "additional_backgrounds":-Array-Elements definieren. Akzeptiert die gleichen Werte wie die CSS background-size-Eigenschaft, wie "auto", "cover", "contain" oder explizite Breiten- und Höhenwerte (zum Beispiel "100px 200px").

Enthält das Array weniger Elemente als das additional_backgrounds-Array, wird das Array für die fehlenden Werte wiederverwendet. Wenn beispielsweise additional_backgrounds 5 Werte enthält und additional_backgrounds_size ["auto", "100px 100px"] enthält, wird das dritte Hintergrundelement mit "auto" skaliert, das vierte mit "100px 100px" und das fünfte "auto".

Wenn nicht angegeben, ist "auto" der Standardwert.

color_scheme

String

Optional

Bestimmt, welches Farbschema auf das Chrome (z.B. Kontextmenüs) und den Inhalt (z.B. eingebaute Seiten und das bevorzugte Farbschema für Webseiten) angewendet wird. Optionen umfassen:

  • "auto" – ein helles oder dunkles Schema basierend automatisch auf dem Thema.
  • "light" – ein helles Schema.
  • "dark" – ein dunkles Schema.
  • "system" – verwendet das System-Schema.

Wenn nicht angegeben, ist "auto" der Standardwert.

content_color_scheme

String

Optional

Bestimmt, welches Farbschema auf den Inhalt angewendet wird (z.B. eingebaute Seiten und bevorzugtes Farbschema für Webseiten). Überschreibt color_scheme. Optionen umfassen:

  • "auto" – ein helles oder dunkles Schema basierend automatisch auf dem Thema.
  • "light" – ein helles Schema.
  • "dark" – ein dunkles Schema.
  • "system" – das System-Schema.

Wenn nicht angegeben, ist "auto" der Standardwert.

Beispiele

Ein einfaches Thema muss ein Bild definieren, das zum Kopfbereich hinzugefügt wird, die verwendete Akzentfarbe im Kopfbereich sowie die im Kopfbereich verwendete Textfarbe:

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

Mehrere Elemente können verwendet werden, um den Kopfbereich zu füllen. Vor Version 60 von Firefox, verwenden Sie ein leeres oder transparentes Header-Bild, um Kontrolle über die Platzierung jedes zusätzlichen Elements zu erhalten:

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 auch den Kopfbereich mit einem wiederholten Bild oder Bildern füllen, in diesem Fall ein einzelnes Bild, das in der Mitte oben im Kopfbereich verankert und über den restlichen Kopfbereich wiederholt wird:

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

Dies wird Ihnen einen Browser geben, der so aussieht:

Ein Browserfenster mit zwei geöffneten Tabs und dunklem Grün als Hintergrundfarbe im Kopfbereich. Der inaktive Tab hat weiße Textfarbe. Der aktive Tab und die Symbolleiste haben eine blaue Hintergrundfarbe mit cyanfarbigem Text. Die URL-Leiste hat eine orange Hintergrundfarbe mit weißen Rändern, eine grüne Textfarbe und eine weiße vertikale Trennlinie. Eine rote Linie wird verwendet, um die Tabs oben zu trennen und eine weiße Linie, um die Tabs von den Inhalten darunter zu trennen.

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

Dieses Beispiel (ab Firefox 153+) mischt Bildhintergründe mit einem CSS-Lineargradient:

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

Dies ergibt:

  • background-image1.svg wird oben rechts mit seiner natürlichen Größe angezeigt.
  • background-image2.svg wird oben links mit seiner natürlichen Größe angezeigt.
  • Der linear-gradient wird von oben rechts ausgehend horizontal über den Kopfbereich gekachelt (repeat-x) und auf eine Höhe von 144px skaliert (Breite ist automatisch). Der Gradient wechselt von pink (#FF6BBA) oben zu pfirsichfarben (#FFC999) unten.

Browser-Kompatibilität

Chrome-Kompatibilität

In Chrome:

  • colors/toolbar_text wird nicht verwendet, verwenden Sie stattdessen colors/bookmark_text.

  • images/theme_frame verankert das Bild oben links im Kopfbereich und wenn das Bild den Kopfbereich nicht ausfüllt, wird das Bild gekachelt.

  • alle Farben müssen als Array von RGB-Werten angegeben werden, wie folgt:

    json
    "theme": {
      "colors": {
         "frame": [255, 0, 0],
         "tab_background_text": [0, 255, 0],
         "bookmark_text": [0, 0, 255]
      }
    }
    

Ab Firefox 59 werden sowohl die Array-Form als auch die CSS-Farb-Form für alle Eigenschaften akzeptiert. Vorher mussten colors/frame und colors/tab_background_text die Array-Form verwenden, während andere Eigenschaften die CSS-Farb-Form erforderten.