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
Obligatorisch 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 Theme zu definieren, das auf Firefox angewendet wird. Wenn der Schlüssel allein bereitgestellt wird, definiert dies das Theme, das verwendet wird, wenn Firefox entweder die helle oder die dunkle Farbgebung verwendet. Wenn der dark_theme-Schlüssel bereitgestellt wird, stellt dieser Schlüssel das Theme bereit, das verwendet wird, wenn Firefox die helle Farbgebung verwendet.

Hinweis: Wenn Sie ein Theme mit einer Erweiterung einbeziehen möchten, lesen Sie die theme API.

Hinweis: Seit Mai 2019 müssen Themes signiert sein, um installiert zu werden (Firefox-Fehler 1545109). Weitere Informationen finden Sie unter Signieren und Verteilen Ihres Add-ons.

Hinweis: Eine neue Version von Firefox für Android, basierend auf GeckoView, befindet sich in der Entwicklung. Eine Vorabversion ist verfügbar. Die Vorabversion unterstützt keine Themes.

Bildformate

Die folgenden Bildformate werden in allen Theme-Bild-Eigenschaften 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 hat:

Name Typ Beschreibung
images Object

Seit Firefox 60 optional. Vor Firefox 60 obligatorisch.

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

colors Object

Obligatorisch.

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 enthält Eigenschaften, die beeinflussen, wie die "additional_backgrounds"-Bilder angezeigt werden und wie Farbgebungen 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 immer den Header-Bereich vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String

Die URL eines Vordergrundbildes, das dem Headerbereich hinzugefügt und an der oberen rechten Ecke des Headerbereichs verankert wird.

Hinweis: Chrome verankert das Bild an der oberen linken Ecke des Headers und wenn das Bild den Headerbereich nicht ausfüllt, wird das Bild gekachelt.

Seit Firefox 60 auf Desktop optional. Erforderlich in Firefox für Android.

additional_backgrounds Array von String

Warnung: Die additional_backgrounds-Eigenschaft ist experimentell. Sie wird derzeit in den Release-Versionen von Firefox akzeptiert, aber ihr Verhalten kann sich ändern. Sie wird in Firefox für Android nicht unterstützt.

Ein Array von URLs für zusätzliche Hintergrundbilder, die dem Headerbereich hinzugefügt und hinter dem "theme_frame":-Bild angezeigt werden. Diese Bilder schichten das erste Bild im Array oben, das letzte Bild im Array unten.

Optional.

Standardmäßig sind alle Bilder an der oberen rechten Ecke des Headerbereichs verankert, aber ihre Ausrichtung und Wiederholungs- verhalten können durch Eigenschaften von "properties": gesteuert werden.

colors

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

Übersicht über die Farbeigenschaften und wie sie auf Firefox-UI-Komponenten angewendet werden

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

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

Hinweis: In Chrome können Farben nur als RGB-Arrays angegeben werden.

In Firefox für Android können Farben angegeben werden mittels:

  • Voller Hexadezimal-Notation, d.h. nur #RRGGBB. alpha und verkürzte Syntax, wie in #RGB[A], werden nicht unterstützt.
  • Funktionale Notation (RGB-Arrays) für Themen, die mindestens Firefox 68.2 anvisieren.

Farben für Firefox für Android-Themen können nicht mit Farbnamen angegeben werden.

Name Beschreibung
bookmark_text

Die Farbe von Texten und Icons in den Lesezeichen- und Suchleisten. Auch, wenn tab_text nicht definiert ist, legt es die Farbe des aktiven Tab-Texts fest und wenn icons nicht definiert ist, die Farbe der Symbolleisten-Icons. Bereitgestellt als Chrome-kompatibler Alias für toolbar_text.

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

Wo icons nicht definiert ist, stellen Sie auch sicher, dass es einen guten Kontrast zu button_background_active und button_background_hover gibt.

Siehe Beispiel
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 Seitenleistenleiste sind weiß mit schwarzem Text, aber alle Icons der Browser- und Seitenleistenleiste sind rot.

button_background_active

Die Hintergrundfarbe der gedrückten Symbolleistenschaltflächen.

Siehe Beispiel
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 Icon zum Anpassen der Symbolleiste in der URL-Leiste ist weiß mit einem roten Hintergrund gedrückt, ein Popup öffnet eine kurze Liste von Elementen, die zur Symbolleiste hinzugefügt werden können, wie die Bibliothek des Browsers und die Seitenleisten.

button_background_hover

Die Hintergrundfarbe der Symbolleistenschaltflächen beim Hover.

Siehe Beispiel
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 Icon zum Zurückgehen ist weiß mit einem roten Kreis-Hintergrund.

icons

Die Farbe der Symbolleisten-Icons, mit Ausnahme derjenigen in der Suchleiste.

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

Siehe Beispiel
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. Die Icons in der URL-Leiste und offene neue Tab Icons sind rot. Die roten Icons kontrastieren gut mit der schwarzen Hintergrundfarbe des Header-Bereichs.

icons_attention

Die Farbe der Symbolleisten-Icons im Aufmerksamkeitszustand wie das markierte Lesezeichen-Icon oder das Icon für beendete Downloads.

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

Siehe Beispiel
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 Icon 'Lesezeichen dieser Seite' ist rot gedrückt, ein Popup 'Dieses Lesezeichen bearbeiten' wird angezeigt. Im Aufmerksamkeitszustand kontrastieren die Symbolleisten-Icons gut mit dem schwarzen Hintergrund des Header-Bereichs.

frame

Die Farbe des Hintergrundes im Headerbereich, die im Teil des Headers angezeigt wird, der nicht durch die in "theme_frame" und "additional_backgrounds" angegebenen Bilder abgedeckt oder sichtbar ist.

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

Browser 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 Farbe des Hintergrunds im Headerbereich, wenn das Browserfenster inaktiv ist, angezeigt im Teil des Headers, der nicht durch die in "theme_frame" und "additional_backgrounds" angegebenen Bilder abgedeckt oder sichtbar ist.

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

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

ntp_background

Die Hintergrundfarbe der neuen Tab-Seite.

Siehe Beispiel
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.

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

Firefox zeigt eine neue Tab-Seite an. Auf der Seite ist der Hintergrund der Suchleiste und der Shortcut Buttons rot.

ntp_text

Die Textfarbe auf der neuen Tab-Seite.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut zu den in ntp_background und ntp_card_background verwendeten Farben kontrastiert.

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

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

popup

Die Hintergrundfarbe von Popups (wie dem Dropdown der URL-Leiste und den Pfeil-Panels).

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

Browser Firefox ist schwarz. Browser-Tabs und URL-Leiste sind hellgrau mit weißen Icons und Text. Das Icon 'Diese Seite Lesezeichen hinzufügen' ist blau und gedrückt, ein Popup 'Dieses Lesezeichen bearbeiten' wird angezeigt mit einem roten Hintergrund. Die Hintergrundfarbe des Popups ist rot.

popup_border

Die Umrandungsfarbe von Popups.

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

Browser Firefox ist schwarz. Browser-Tabs und URL-Leiste sind hellgrau mit weißen Icons und Text. Das Icon 'Diese Seite Lesezeichen hinzufügen' ist blau und gedrückt, ein Popup 'Dieses Lesezeichen bearbeiten' wird angezeigt mit einer roten Umrandung und schwarzem Hintergrund. Der Rand des Popups ist rot.

popup_highlight

Die Hintergrundfarbe von hervorgehobenen Elementen, die mithilfe der Tastatur innerhalb von Popups (wie dem ausgewählten URL-Leisten-Dropdown-Element) ausgewählt werden.

Hinweis: Es wird empfohlen, popup_highlight_text zu definieren, um die Standardeinstellungen des Browser-Textes auf verschiedenen Plattformen zu überschreiben.

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

Screenshot von Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind hellgrau mit weißen Icons und Text. Ein Suchergebnis-Popup wird mit einem hervorgehobenen Element angezeigt, das einen roten Hintergrund hat. Die Hintergrundfarbe des hervorgehobenen Elements im Popup ist rot.

popup_highlight_text

Die Textfarbe von hervorgehobenen Elementen innerhalb von Popups.

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

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

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

popup_text

Die Textfarbe von Popups.

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

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

Browser Firefox ist schwarz. Browser-Tabs und URL-Leiste sind hellgrau mit weißen Icons und Text. Ein Suchergebnis-Popup wird mit rotem Text angezeigt. Die Textfarbe kontrastiert gut mit der schwarzen Hintergrundfarbe des Popups.

sidebar

Die Hintergrundfarbe der Seitenleiste.

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

Ein Nahaufnahme-Screenshot eines geöffneten Sidebar-Fensters in einem Browser. Die Hintergrundfarbe der Sidebar ist rot.

sidebar_border

Die Rand- und Trennerfarbe der Browser-Seitenleiste

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

Ein Nahaufnahme der Lesezeichen-Sidebar des Firefox-Browsers mit einem roten horizontalen Trenner zwischen dem Seitenleistennamen und dem Seitenleistenmenü. Die Rand- und Trennerfarbe der Sidebar ist rot.

sidebar_highlight

Die Hintergrundfarbe von hervorgehobenen Zeilen in eingebauten Sidebars

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

Ein Nahaufnahme der Lesezeichen-Sidebar des Firefox-Browsers mit einem hervorgehobenen Element. Die Hintergrundfarbe einer hervorgehobenen Zeile in der Sidebar ist rot mit weißem Text.

sidebar_highlight_text

Die Textfarbe von hervorgehobenen Zeilen in Sidebars.

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

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

Ein Nahaufnahme der Lesezeichen-Sidebar des Firefox-Browsers mit einem hervorgehobenen Element. Die Farbe des Textes einer hervorgehobenen Zeile in der Sidebar ist rot. Die Textfarbe kontrastiert gut mit der pinkfarbenen Hintergrundfarbe der hervorgehobenen Zeile.

sidebar_text

Die Textfarbe der Sidebars.

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

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

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

tab_background_separator

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

Die Farbe des vertikalen Trenner der Hintergrund-Tabs.

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

Eine Nahaufnahme von Browser-Tabs, um den Trenner hervorzuheben.

tab_background_text

Die Farbe des Textes, der in den inaktiven Seitentabs angezeigt wird. Wenn tab_text oder bookmark_text nicht angegeben ist, gilt die Farbe auch für den aktiven Tab-Text.

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

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

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

tab_line

Die Farbe des ausgewählten Tab-Linie.

Siehe Beispiel
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 Icons und weißem Text. Der ausgewählte Tab hat eine rote Umrandung.

tab_loading

Die Farbe des Ladeindikators und des Ladebursts des Tabs.

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

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

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Wenn nicht verwendet, wird die ausgewählte Tab-Farbe durch frame und frame_inactive eingestellt.

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Der Browser ist schwarz. Die Tabs und die URL-Leiste des Browsers sind dunkler grau mit Icons 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 zu den in tab_selected oder frame und frame_inactive verwendeten Farben kontrastiert.

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

Browser Firefox hat ein Tiermotivrepet. Die URL-Leiste ist heller grau mit weißen Icons. 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 stellt auch die Hintergrundfarbe der "Suchen"-Leiste ein.

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

Browser Firefox ist schwarz. BRowser-Tab, Suche in Seite Leiste und URL-Leiste sind rot mit weißem Text und Icons, mit Ausnahme der Suchleiste, wo der Text und das Icon schwarz sind.

toolbar_bottom_separator

Die Farbe der Linie, die den unteren Rand der Symbolleiste vom darunter liegenden Bereich trennt.

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

Browser Firefox ist schwarz. Browser-Tab und URL-Leiste sind hellgrau mit weißem Text und Icons. Eine horizontale rote Linie trennt den unteren Rand der Symbolleiste vom Beginn der Anzeige der Webseite.

toolbar_field

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

Dies setzt auch die Hintergrundfarbe des Such-in-der-Seite Feldes.

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

Browser Firefox ist schwarz. Browser-Tab, Suche in Seite Leiste und URL-Leiste sind hellgrau mit weißen Icons und Text. Der Hintergrund der URL-Leiste ist rot. Die Such-in-der-Seite Leiste ist weiß mit schwarzem Text. Das Such-in-der-Seite Feld ist rot mit schwarzem Text.

toolbar_field_border

Die Umrandungsfarbe für Felder in der Symbolleiste.

Dies setzt auch die Rahmenfarbe des Such-in-der-Seite Feldes.

Siehe Beispiel
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. Browser-Tab, Suche in Seite Leiste und URL-Leiste sind schwarz mit weißem Text und Icons. Die URL-Leiste und das Such-in-der-Seite Feld sind in Rot umrandet.

toolbar_field_border_focus

Die fokussierte Umrandungsfarbe für Felder in der Symbolleiste.

Siehe Beispiel
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. Browser-Tab und URL-Leiste sind schwarz mit weißem Text und Icons. Das URL-Leistenfeld ist fokussiert und in rot umrandet.

toolbar_field_focus

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

Siehe Beispiel
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. Browser-Tab, Suche in Seite Leiste und URL-Leiste sind schwarz mit weißem Text und Icons. Der Hintergrund der fokussierten URL-Leiste ist rot und der Text ist weiß.

toolbar_field_highlight Die Hintergrundfarbe zur Anzeige der aktuellen Auswahl von Text in der URL-Leiste (und der Suchleiste, falls konfiguriert, um separat zu sein).
Siehe Beispiel
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ß. Browser-Tab und URL-Leiste sind weiß mit Text und Icons in schwarz. Das URL-Leistenfeld ist fokussiert und in blau umrandet und der Text in der URL-Leiste ist ausgewählt.

Hier spezifiziert das toolbar_field_highlight Feld, dass die Hervorhebungsfarbe ein helles Grün ist, während der Text auf ein dunkel bis mittleres Grün mit toolbar_field_highlight_text gesetzt ist.

toolbar_field_highlight_text

Die Farbe, die verwendet wird, um Text zu zeichnen, der derzeit in der URL-Leiste (und der Suchleiste, falls konfiguriert, um separat zu sein) ausgewählt ist.

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

Siehe Beispiel
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ß. Browser-Tab und URL-Leiste sind weiß mit Text und Icons in schwarz. Das URL-Leistenfeld ist fokussiert und in 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 dunkel bis mittleres Grün zu setzen, während die Hervorhebungsfarbe ein helles Grün ist.

toolbar_field_separator

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

Die Farbe der Trenner in der URL-Leiste. In Firefox 58 wurde dies als toolbar_vertical_separator implementiert.

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Browser Firefox ist schwarz. Browser-Tab und URL-Leiste sind schwarz mit Text und Icons in weiß. In der weißen URL-Leiste, nach dem Leser-Modus Icon, eine rote vertikale Linie, die den Rest der URL-Leisten-Icons trennt. Die Farbe der vertikalen Trennerlinie in der URL-Leiste ist rot.

In diesem Screenshot ist "toolbar_vertical_separator" die rote vertikale Linie in der URL-Leiste, die das Reader-Modus-Icon von den anderen Icons 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 Such-in-der-Seite Feld.

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

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Der Browser ist schwarz. Browser-Tab und URL-Leiste sind schwarz mit weißem Text und Icons. Der Text in der URL-Leiste ist rot. Die Icons und das Such-in-der-Seite Feld haben roten Text mit 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 zu der in toolbar_field_focus verwendeten Farbe kontrastiert.

Siehe Beispiel
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 offenen Tabs. Der Browser ist schwarz. Browser-Tab und URL-Leiste sind schwarz mit Text und Icons in weiß. Die URL-Leiste hat den Fokus; der Text und die Icons sind rot mit schwarzem Hintergrund.

toolbar_text

Die Farbe des Symbolleisten-Textes. Diese setzt auch die Farbe des Textes in der "Suchen"-Leiste.

Hinweis: Für die Kompatibilität mit Chrome verwenden Sie den Alias bookmark_text.

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Der Browser ist schwarz. Browser-Tab, Suchleiste, und URL-Leiste sind schwarz mit rotem Text und Icons. Der Text im aktiven Tab, der Navigationsleiste und der Suchleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die den oberen Rand der Symbolleiste von dem darüber liegenden Bereich trennt.

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Der Browser ist schwarz. Browser-Tab und URL-Leiste sind schwarz mit weißem Text und Icons. Eine rote Linie trennt den oberen Rand der URL-Leiste vom Browser.

toolbar_vertical_separator

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

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

Ein Screenshot eines Browserfensters mit einem offenen Tab. Der Browser ist schwarz. Browser-Tab und URL-Leiste sind schwarz mit Text und Icons in weiß. Die Farbe der vertikalen Linie, die die Lesezeichen-Symbolleiste vom 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 gegeben ist und die Version ohne Alias ebenfalls gegeben ist, wird der Wert aus der Version ohne Alias übernommen.

Name Alias für
bookmark_text toolbar_text

properties

Name Typ Beschreibung
additional_backgrounds_alignment

Array von String

Optional

Ein Array von Enumerationswerten, das die Ausrichtung des entsprechenden "additional_backgrounds":-Arrayelements definiert.
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".

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

additional_backgrounds_tiling

Array von String

Optional

Ein Array von Enumerationswerten, das definiert, wie das entsprechende "additional_backgrounds":-Arrayelement wiederholt wird. Optionen umfassen:

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

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

color_scheme

String

Optional

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

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

Wenn nicht angegeben, ist der Standardwert "auto".

content_color_scheme

String

Optional

Bestimmt, welches Farbschema auf den Inhalt angewendet wird (zum Beispiel eingebaute Seiten und das bevorzugte Farbschema für Webseiten). Überschreibt color_scheme. Optionen umfassen:

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

Wenn nicht angegeben, ist der Standardwert "auto".

Beispiele

Ein grundlegendes Theme muss ein Bild definieren, das dem Header hinzugefügt wird, die Akzentfarbe, die im Header verwendet werden soll, und die Farbe des im Header verwendeten Textes:

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

Mehrere Bilder können verwendet werden, um den Header zu füllen. Vor Firefox Version 60 verwenden Sie ein leeres oder transparentes Header-Bild, um die Platzierung jedes zusätzlichen Bildes zu steuern:

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 wiederholten Bild oder Bildern füllen, in diesem Fall ein einzelnes Bild, das in der Mitte oben im Header verankert und über den Rest des Headers 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"
    }
  }

Es gibt Ihnen einen Browser, der so aussieht:

Ein Browserfenster mit zwei offenen Tabs und dunkelgrüner Hintergrundfarbe im Headerbereich. Der inaktive Tab hat eine weiße Textfarbe. Der aktive Tab und die Symbolleiste haben eine blaue Hintergrundfarbe mit Text in Zyan. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rändern, eine grüne Textfarbe und einen weißen vertikalen Liniensetzer. Eine rote Linie wird verwendet, um die Tabs oben zu trennen, und eine weiße Linie, um die Tabs vom darunterliegenden Inhalt zu trennen.

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der URL-Leiste, die das Reader-Modus-Icon von den anderen Icons trennt.

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 links oben im Header; wenn das Bild den Headerbereich nicht ausfüllt, wird das Bild gekachelt.

  • Alle Farben müssen als ein 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 können beide Formen, das Array-Format und das CSS-Farbformat, für alle Eigenschaften verwendet werden. Davor erforderten colors/frame und colors/tab_background_text das Array-Format, während andere Eigenschaften das CSS-Farbformat erforderten.