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 Theme festzulegen, das auf Firefox angewendet werden soll. Wenn dieser allein bereitgestellt wird, definiert er das Theme, das verwendet wird, wenn Firefox entweder das helle oder dunkle Farbschema verwendet. Wenn der dark_theme-Schlüssel bereitgestellt wird, bietet dieser Schlüssel das Theme, das verwendet wird, wenn Firefox das helle Farbschema verwendet.

Hinweis: Wenn Sie ein Theme 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-Fehler 1545109). Sehen Sie Signing and distributing your add-on für weitere Details.

Bildformate

Die folgenden Bildformate werden in allen Theme-Bildattributen unterstützt:

  • JPEG
  • PNG
  • APNG
  • SVG (animierte SVG werden ab Firefox 59 unterstützt)
  • GIF (animierte GIF werden nicht unterstützt)

Syntax

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

Name Typ Beschreibung
images Object

Optional ab Firefox 60. Vor Firefox 60 verpflichtend.

Ein JSON-Objekt, dessen Eigenschaften die in verschiedenen Bereichen des Browsers anzuzeigenden Bilder darstellen. 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 werden und Farbschemata 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 Header-Bereich immer vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String oder Object

Ein Vordergrundbild (definiert durch den Pfad zu einer Bildressource, die in der Erweiterung verpackt ist) oder CSS-Gradient, das dem Headerbereich hinzugefügt wird und an der oberen rechten Ecke des Headerbereichs verankert ist. CSS-Gradients werden ab Firefox 153 unterstützt.

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

Optional in Desktop Firefox ab Version 60.

additional_backgrounds Array von String oder Object

Warnung: Die additional_backgrounds Eigenschaft ist experimentell. Es wird in den veröffentlichten Versionen von Firefox akzeptiert, aber sein Verhalten kann sich ändern.

Ein Array zusätzlicher Hintergrundelemente, von denen jedes entweder der Pfad zu einer Bildressource, die in der Erweiterung verpackt ist, oder ein CSS-Gradient ist, welches dem Headerbereich hinzugefügt wird 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-Gradients werden ab Firefox 153 unterstützt.

Optional

Standardmäßig sind alle Elemente an der oberen rechten Ecke des Headerbereichs verankert, aber ihre Ausrichtung, Wiederholung und Größenverhalten sowie das Bereich des Browserfensters, in dem sie gezeichnet werden, können von "properties": gesteuert werden.

Da zusätzliche Hintergrundelemente hinter dem theme_frame-Element angezeigt werden, sind diese ausgeblendeten, wenn theme_frame als CSS-Gradient gesetzt ist.

CSS-Gradientsyntax

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

  • GRADIENT_TYPE ist einer der folgenden:
    • linear-gradient
    • radial-gradient
    • conic-gradient
    • repeating-linear-gradient
    • repeating-radial-gradient
    • repeating-conic-gradient
  • GRADIENT_PARAMS enthält die Parameter für diese CSS-Gradientfunktion, wie in CSS Gradientwerte 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 ihre Anwendung auf die Firefox-Benutzeroberfläche

Hinweis: Wenn ein Bestandteil von mehreren Farbeigenschaften betroffen ist, sind die Eigenschaften in der Reihenfolge ihrer Priorität aufgeführt.

Alle diese Eigenschaften können entweder als Zeichenfolge angegeben werden, die einen gültigen CSS-Farbenstring (einschließlich hexadezimal) enthält, oder als RGB-Array, wie zum Beispiel "tab_background_text": [ 107 , 99 , 23 ].

Name Beschreibung
bookmark_text

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

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

Wenn icons nicht definiert ist, stellen Sie auch sicher, dass ein guter Kontrast mit 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 Symbole in diesen Leisten 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 anpassbare Symbol in der URL-Leiste ist weiß mit einem roten Hintergrund und gedrückt; ein Popup ist geöffnet, das eine kurze Liste von zum Werkzeug hinzufügbare Elemente anzeigt, wie z.B. die Bibliothek des Browsers und die Seitenleisten.

button_background_hover

Die Hintergrundfarbe der Symbolleistenschaltflächen beim Darüberfahren.

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

Browser Firefox ist schwarz. Die Browser-Tabs und die URL-Leiste sind grau mit weißem Text. Das Symbol zum Zurückgehen auf einer Seite ist weiß mit einem roten Kreis als Hintergrund.

icons

Die Farbe der Symbolleistensymbole, außer denen in der Suchsymbolleiste.

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

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

Browser Firefox ist schwarz. Die Browser-Tabs und die URL-Leiste sind grau mit weißem Text. Die URL-Leiste und das neue Tab-Symbol sind rot. Die roten Symbole kontrastieren gut mit der schwarzen Hintergrundfarbe des Headerbereichs.

icons_attention

Die Farbe der Symbolleistensymbole im Status der Aufmerksamkeit, wie das Sternsymbol des Lesezeichens oder das Symbol des abgeschlossenen Downloads.

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

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

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

frame

Die Farbe des Headerbereichs-Hintergrunds, der in dem Teil des Headers angezeigt wird, der nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen verdeckt oder sichtbar ist.

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

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

frame_inactive

Die Farbe des Headerbereichs-Hintergrunds, wenn das Browserfenster inaktiv ist, angezeigt in dem Teil des Headers, der nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen verdeckt oder sichtbar ist.

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

Browser Firefox ist grau. Browsers Tabs und URL-Leiste sind heller grau. Der Tab-Text ist weiß und die Symbole der URL-Leiste 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. 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. Auf der Seite ist der Hintergrund der Suchleiste und der Schaltflächen für Verknüpfungen rot.

ntp_text

Die Textfarbe auf der neuen Tab-Seite.

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

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

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

popup

Die Hintergrundfarbe von Popups (wie die Dropdown-Liste 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 'Diese Seite als Lesezeichen speichern' ist blau und gedrückt, ein offenes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird mit einem roten Hintergrund angezeigt. Die Hintergrundfarbe des Popups ist rot.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit weißen Symbolen und Text. Das Symbol 'Diese Seite als Lesezeichen speichern' ist blau und gedrückt; ein offenes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird mit einem roten Rahmen und schwarzem Hintergrund angezeigt. Der Rahmen des Popups ist rot.

popup_highlight

Die Hintergrundfarbe von in Popups hervorgehobenen Elementen, die über die Tastatur ausgewählt werden (wie das ausgewählte Dropdown-Element 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"
  }
}

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

popup_highlight_text

Die Textfarbe von hervorgehobenen Elementen in Popups.

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 Suchergebnisse-Popup wird mit einem hervorgehobenen Element angezeigt, dessen Text rot und Hintergrund schwarz ist. 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 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 Suchergebnisse-Popup wird mit roten Texten angezeigt. Die Textfarbe kontrastiert gut mit der schwarzen Hintergrundfarbe des Popups.

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 einer geöffneten Seitenleiste eines Browserfensters. Die Hintergrundfarbe der Seitenleiste ist rot.

sidebar_border

Die Rahmen- und Trennlinienfarbe der Browsersidebar

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

Ein Nahaufnahme der Firefox Browser-Lesezeichenseitenleiste mit einer roten horizontalen Trennlinie zwischen dem Listentitel und dem Menü in der Seitenleiste. Die Rahmen- und Trennlinienfarbe der Seitenleiste ist rot.

sidebar_highlight

Die Hintergrundfarbe der hervorgehobenen Zeilen in integrierten Seitenleisten

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

Ein Nahaufnahme der Firefox Browser-Lesezeichenseitenleiste 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 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 Firefox Browser-Lesezeichenseitenleiste 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 eines geöffneten Seitenleistenfensters eines Browsers. Die Textfarbe 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 Trennzeichens der Hintergrundtabs.

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

Eine Nahaufnahme der Browser-Tabs, um das Trennzeichen hervorzuheben.

tab_background_text

Die Farbe des Textes, der in den inaktiven Seiten-Tabs angezeigt wird. Wenn tab_text oder bookmark_text nicht festgelegt ist, wird es auf den aktiven Tab-Text angewendet.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit jenen 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 des ausgewählten Tabs.

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 des Tabs und der Ladeburst des Tabs.

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 weißen Symbolen und Text. Innerhalb des ausgewählten Tabs 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 weißen Symbolen und Text. Der ausgewählte Tab hat einen roten Hintergrund und weißen Text.

tab_text

Ab Firefox 59 stellt er die Textfarbe für den ausgewählten Tab dar. Wenn tab_line nicht festgelegt ist, definiert er auch die Farbe der Linie des ausgewählten Tabs.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe gut mit den 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 Insekt-Thema. 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 "Finden"-Leiste fest.

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

Browser Firefox ist schwarz. Die Tabs, die Seite-finden-Leiste und die URL-Leiste des Browsers sind rot mit weißen Texten und Symbolen, mit Ausnahme der Seite-finden-Leiste, wo der Text und das Symbol schwarz sind.

toolbar_bottom_separator

Die Farbe der Linie, die den unteren Bereich der Symbolleiste von dem darunter liegenden Bereich 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 des Browsers sind heller grau mit weißen Texten und Symbolen. Eine horizontale rote Linie trennt die Unterseite der Symbolleiste und den Anfang der Anzeigeseite.

toolbar_field

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

Dies legt auch die Hintergrundfarbe des Seite-finden Feldes fest.

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

Browser Firefox ist schwarz. Der Tab, die Seite-finden-Leiste und die URL-Leiste des Browsers sind heller grau mit weißen Texten und Symbolen. Die Hintergrundfarbe der URL-Leiste ist rot. Die Seite-finden-Leiste ist weiß mit schwarzem Text, und das Seite-finden-Feld ist rot mit schwarzem Text.

toolbar_field_border

Die Rahmenfarbe für Felder in der Symbolleiste.

Dies legt auch die Rahmenfarbe des Seite-finden Feldes 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. Der Tab, die Seite-finden-Leiste und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Die URL-Leiste und das Seite-finden-Feld sind in 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 des Browsers sind schwarz mit weißem Text und Symbolen. 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.

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 Seite-finden-Leiste und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Die Hintergrundfarbe der fokussierten URL-Leiste ist rot, und der Text ist weiß.

toolbar_field_highlight Die Hintergrundfarbe, die verwendet wird, um die aktuelle Textauswahl in der URL-Leiste anzuzeigen (und die Suchleiste, wenn sie so konfiguriert ist, dass sie separat 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)"
  }
}

Browser Firefox ist weiß. Die Tabs des Browsers und die URL-Leiste sind weiß mit Text und Symbolen in schwarz. Das URL-Leistenfeld ist fokussiert und in blau umrandet sowie URL-Leistentext ausgewählt.

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

toolbar_field_highlight_text

Die Farbe, die verwendet wird, um Text zu zeichnen, der derzeit in der URL-Leiste ausgewählt ist (und der Suchleiste, wenn sie als separater Kasten konfiguriert ist).

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 des Browsers und die URL-Leiste sind weiß mit Text und Symbolen in schwarz. Das URL-Leistenfeld ist fokussiert und in blau umrandet sowie URL-Leistentext ausgewählt.

Hier wird das toolbar_field_highlight_text-Feld verwendet, um die Textfarbe auf ein mittleres Dunkelgrün einzustellen, 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 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 Text und Symbolen in weiß. Innerhalb des weißen URL-Leistenfelds, nach dem Reader-Mode-Symbol, eine rote vertikale Linie, die den Rest der URL-Leistensymbole trennt. Die Farbe der vertikalen Trennlinie innerhalb der URL-Leiste ist rot.

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

toolbar_field_text

Die Farbe des Textes in Feldern in der Symbolleiste, wie die URL-Leiste. Dies legt auch die Farbe des Textes im Seite-finden Feld 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 Seite-finden-Feld haben roten Text mit schwarzem Hintergrund.

toolbar_field_text_focus

Die Farbe des Textes in fokussierten Feldern in der Symbolleiste, wie die 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 Text und Symbolen in weiß. Die URL-Leiste ist fokussiert; der Text und die Symbole in der Leiste sind rot mit schwarzem Hintergrund.

toolbar_text

Die Farbe des Textes in der Symbolleiste. Dies legt auch die Farbe des Textes in der "Finden"-Leiste fest.

Hinweis: Für die 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 Seite-finden-Leiste und die URL-Leiste des Browsers sind schwarz mit rotem Text und Symbolen. Der Text innerhalb des aktiven Tabs, der Navigationsleiste und der Findeleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die den oberen Bereich der Symbolleiste von dem darüber liegenden Bereich 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 den oberen Bereich der URL-Leiste vom Rest des Browsers.

toolbar_vertical_separator

Die Farbe der Trennlinie in der Lesezeichensymbolleiste. In Firefox 58 entspricht dies der Farbe der Trennlinien innerhalb 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 Text und Symbolen in weiß. Die Farbe der vertikalen Linie, die die Lesezeichensymbolleiste 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 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".

Wenn das Array enthält weniger Elemente als das additional_backgrounds Array, wird das Array für die fehlenden Werte wiederverwendet. Zum Beispiel, wenn additional_backgrounds 5 Werte enthält und additional_backgrounds_alignment ["left", "top"] enthält, wird das dritte Hintergrundelement unter Verwendung von "left", das vierte unter Verwendung von "top" und das fünfte "left" ausgerichtet.

Wenn nicht angegeben, ist die Standardeinstellung "right top".

additional_backgrounds_tiling

Array von String

Optional

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

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

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

Wenn nicht angegeben, ist die Standardeinstellung "no-repeat".

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 zum Beispiel "auto", "cover", "contain" oder explizite Breiten- und Höhenwerte (zum Beispiel, "100px 200px").

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

Wenn nicht angegeben, ist die Standardeinstellung "auto".

backgrounds_area

String

Optional

Bestimmt den Bereich des Browserfensters, in dem die Hintergrundbilder und Verläufe des Themes gezeichnet werden. Zu den Optionen gehören:

  • "auto" – Firefox wählt den Bereich basierend auf additional_backgrounds_alignment. Wenn ein Ausrichtungswert einen Hintergrund in der vertikalen Mitte oder am unteren Rand des Headerbereichs positioniert, werden die Hintergründe in den oberen Symbolleisten gezeichnet. Andernfalls werden sie im Fenster gezeichnet.
  • "window" – die Hintergründe werden im gesamten Browserfenster gezeichnet, so dass sie sich hinter vertikalen Benutzeroberflächen erstrecken, wie die Seitenleiste und vertikale Tabs.
  • "top_toolbars" – die Hintergründe werden nur in den horizontalen Symbolleisten oben im Fenster gezeichnet, das heißt, der Menüleiste, der Tableiste, der Navigationssymbolleiste und der Lesezeichensymbolleiste. Vertikale Benutzeroberflächen, wie die Seitenleiste, verwenden stattdessen die frame Farbe.

Wenn nicht angegeben, ist die Standardeinstellung "auto".

color_scheme

String

Optional

Bestimmt, welches Farbschema auf das Chrome (zum Beispiel, Kontextmenüs) und den Inhalt (zum Beispiel, eingebettete Seiten und das bevorzugte Farbschema für Webseiten) angewendet wird. Zu den Optionen gehören:

  • "auto" – ein helles oder dunkles Schema, das automatisch basierend auf dem Theme gewählt wird.
  • "light" – ein helles Schema.
  • "dark" – ein dunkles Schema.
  • "system" – verwendet das System-Schema.

Wenn nicht angegeben, ist die Standardeinstellung "auto".

content_color_scheme

String

Optional

Bestimmt, welches Farbschema auf den Inhalt (zum Beispiel, eingebettete Seiten und bevorzugtes Farbschema für Webseiten) angewendet wird. Überschreibt color_scheme. Zu den Optionen gehören:

  • "auto" – ein helles oder dunkles Schema, das automatisch basierend auf dem Theme gewählt wird.
  • "light" – ein helles Schema.
  • "dark" – ein dunkles Schema.
  • "system" – das System-Schema.

Wenn nicht angegeben, ist die Standardeinstellung "auto".

Beispiele

Ein grundlegendes Thema muss ein Bild definieren, das dem Header hinzugefügt wird, die Akzentfarbe, die im Header verwendet wird, und die Textfarbe, die im Header verwendet wird:

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

Mehrere Elemente 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 Elements 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 oben in der Mitte des Headers verankert ist 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 wird Ihnen einen Browser geben, der so aussieht:

Ein Browserfenster mit zwei offenen Tabs und einem dunkelgrünen Hintergrund im Header-Bereich. Der inaktive Tab hat eine weiße Textfarbe. Der aktive Tab und die Toolbar haben einen blauen Hintergrund mit cyanfarbener Schrift. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rahmen, eine grüne Schriftfarbe und einen weißfarbenen vertikalen Linienseparator. 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-Mode-Symbol von den anderen Symbolen trennt.

Dieses Beispiel (Firefox 153+) mischt Bildhintergründe mit einem CSS linear gradient:

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 führt zu:

  • 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, horizontal über den Header gekachelt (repeat-x), und auf 144px Höhe skaliert (Breite ist automatisch). Der Gradient wechselt von Pink (#FF6BBA) oben zu Pfirsich (#FFC999) unten.

Dieses Beispiel (Firefox 156+) beschränkt den Hintergrundgradienten auf die horizontalen Toolbars am oberen Rand des Fensters, sodass er sich nicht hinter die Seitenleiste oder vertikale Tabs erstreckt. Ohne backgrounds_area bewirkt die "right top"-Ausrichtung, dass Firefox den Gradient auf das gesamte 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"
  }
}

Mit backgrounds_area auf "top_toolbars" gesetzt, verwendet die Seitenleiste die frame-Farbe. Wenn backgrounds_area auf "window" geändert wird, wird der Gradient über das gesamte Fenster gezeichnet, einschließlich hinter der Seitenleiste.

Browser-Kompatibilität

Chrome-Kompatibilität

In Chrome:

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

  • images/theme_frame verankert das Bild oben links im Header und wenn das Bild den Header-Bereich 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 werden sowohl die Array-Form als auch die CSS-Farbform für alle Eigenschaften akzeptiert. Davor erforderten colors/frame und colors/tab_background_text die Array-Form, während andere Eigenschaften die CSS-Farbform erforderten.