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
Pflicht 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 in Firefox angewendet werden soll. Wenn es alleine bereitgestellt wird, definiert es 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 einbinden möchten, beachten Sie bitte die theme API.

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

Bildformate

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

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

Syntax

Der Theme-Schlüssel ist ein Objekt, das die folgenden Eigenschaften enthält:

Name Typ Beschreibung
images Object

Optional ab Firefox 60. Pflicht vor Firefox 60.

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

Pflicht

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 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 immer den Header-Bereich vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String or Object

Ein Vordergrundbild (definiert durch den Pfad zu einem im Add-on gepackten Bild) oder CSS-Gradient, das dem Header-Bereich hinzugefügt wird und an der oberen rechten Ecke des Header-Bereichs verankert ist. CSS-Gradienten werden ab Firefox 153 unterstützt.

Hinweis: In Chrome wird das Bild am oberen linken Rand des Headers verankert und, wenn das Bild den Header-Bereich nicht ausfüllt, das Bild gekachelt.

Optional in Desktop-Firefox ab Version 60.

additional_backgrounds Array of String or Object

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

Ein Array zusätzlicher Hintergrundelemente, die jeweils entweder der Pfad zu einem im Add-on gepackten Bild oder ein CSS-Gradient sind, die dem Header hinzugefügt und hinter dem "theme_frame":-Element angezeigt werden. Diese zusätzlichen Hintergrundelemente schichten das erste Element im Array oben und das letzte unten. CSS-Gradienten werden ab Firefox 153 unterstützt.

Optional

Standardmäßig sind alle Elemente am oberen rechten Rand des Header-Bereichs verankert, aber ihre Ausrichtung, Wiederholung und Größenverhalten können über "properties": gesteuert werden.

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

CSS-Gradient-Syntax

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

  • GRADIENT_TYPE eine 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 der Farbeigenschaften und ihrer Anwendung auf Firefox-UI-Komponenten

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

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

Name Beschreibung
bookmark_text

Die Farbe von Text und Symbolen in den Lesezeichen- und Suchleisten. Außerdem setzt es, wenn tab_text nicht definiert ist, die Farbe des Textes des aktiven Tabs und, wenn icons nicht definiert ist, die Farbe der Symbolleiste. Bereitgestellt als Chrome-kompatibler Alias für toolbar_text.

Hinweis: Stellen Sie sicher, dass jede verwendete Farbe einen guten Kontrast zu den in frame und frame_inactive oder toolbar, wenn Sie diese Eigenschaft verwenden, genutzten Farben bietet.

Wenn icons nicht definiert ist, auch einen guten Kontrast mit button_background_active und button_background_hover sicherstellen.

Beispiel ansehen
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 Seite-Suchleiste sind weiß mit schwarzem Text, aber alle Symbole des Browsers und der Seite-Suchleiste sind rot.

button_background_active

Die Farbe des Hintergrunds der gedrückten Symbolleistenschaltflächen.

Beispiel ansehen
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 zum Anpassen der Toolbar in der URL-Leiste in weiß mit einem roten Hintergrund ist gedrückt und ein Popup ist geöffnet, das eine kurze Liste von Elementen zum Hinzufügen zur Toolbar anzeigt, wie zum Beispiel die Bibliothek des Browsers und die Seitenleisten.

button_background_hover

Die Farbe des Hintergrunds der Symbolleistenschaltflächen beim Überfahren mit der Maus.

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

icons

Die Farbe der Symbolleistensymbole, abgesehen von denen in der Suchleiste.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu denen bietet, die in frame, frame_inactive, button_background_active und button_background_hover genutzt werden.

Beispiel ansehen
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 Symbole der URL-Leiste und das neue Tab öffnen sind rot. Die roten Symbole kontrastieren gut mit der schwarzen Hintergrundfarbe des Headerbereichs.

icons_attention

Die Farbe von Symbolleistensymbolen im Aufmerksamkeit-Zustand wie das Sternchensymbol im Lesezeichen oder das Symbol für abgeschlossene Downloads.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu denen bietet, die in frame, frame_inactive, button_background_active und button_background_hover genutzt werden.

Beispiel ansehen
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 Seiten-Lesezeichen ist rot und gedrückt, ein geöffnetes Popup-Fenster namens 'Bearbeiten dieses Lesezeichens' wird angezeigt. Im Aufmerksamkeit-Zustand kontrastieren die Toolbarsymbole gut mit dem schwarzen Hintergrund des Header-Bereichs.

frame

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

Beispiel ansehen
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 des Kopfbereichs, wenn das Browserfenster inaktiv ist, angezeigt in dem Teil des Headers, der nicht von den in "theme_frame" und "additional_backgrounds" angegebenen Elementen bedeckt oder sichtbar ist.

Beispiel ansehen
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 Symbole der URL-Leiste sind dunkler grau.

ntp_background

Die Hintergrundfarbe der neuen Tab-Seite.

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

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

ntp_card_background

Die Hintergrundfarbe der Karte auf der neuen Tab-Seite.

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

Firefox zeigt eine neue Tab-Seite. Auf der Seite ist der Hintergrund des Suchbalkens und der Schnellzugriffstasten rot.

ntp_text

Die Textfarbe der neuen Tab-Seite.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu denen hat, die in ntp_background und ntp_card_background genutzt werden.

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

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

popup

Die Hintergrundfarbe von Popups (wie das Dropdown der URL-Leiste und die Pfeiltasten-Panel).

Beispiel ansehen
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 Symbolen und Text in Weiß. Das Symbol 'Diese Seite mit Lesezeichen versehen' ist blau und gedrückt, ein geöffnetes Popup namens 'Dieses Lesezeichen bearbeiten' wird mit rotem Hintergrund angezeigt. Die Hintergrundfarbe des Popups ist rot.

popup_border

Die Rahmenfarbe von Popups.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in Weiß. Das Symbol 'Diese Seite mit Lesezeichen versehen' ist blau und gedrückt, ein geöffnetes Popup namens 'Dieses Lesezeichen bearbeiten' wird mit einem roten Umriss und schwarzem Hintergrund angezeigt. Der Rahmen des Popups ist rot.

popup_highlight

Die Hintergrundfarbe von mit der Tastatur markierten Elementen in Popups (wie das ausgewählte Dropdown-Element der URL-Leiste).

Hinweis: Es wird empfohlen, popup_highlight_text zu definieren, um die standardmäßige Textfarbe des Browsers auf verschiedenen Plattformen zu überschreiben.

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

Screenshot von Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in Weiß. Ein Suchergebnisse-Popup wird angezeigt, wobei der Hintergrund eines markierten Elements rot ist. Die Hintergrundfarbe des markierten Elements im Popup ist rot.

popup_highlight_text

Die Textfarbe von markierten Elementen in Popups.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu der in popup_highlight genutzten hat.

Beispiel ansehen
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 Symbolen und Text in Weiß. Ein Suchergebnisse-Popup wird angezeigt, wobei der Text eines markierten Elements rot mit schwarzem Hintergrund ist. Die Textfarbe des markierten Elements kontrastiert gut mit der schwarzen Hintergrundfarbe dieses Elements.

popup_text

Die Textfarbe von Popups.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu der in popup genutzten hat.

Beispiel ansehen
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 Symbolen und Text in Weiß. Ein Suchergebnisse-Popup wird angezeigt, wobei die Texte der Elemente rot sind. Die Textfarbe kontrastiert gut mit der schwarzen Hintergrundfarbe des Popups.

sidebar

Die Hintergrundfarbe der Seitenleiste.

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

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

sidebar_border

Die Rahmen- und Trennlinienfarbe der Browsersidebar

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

Eine Nahaufnahme der Firefox-Browser-Lesezeichenseitenleiste mit einer roten horizontalen Trennlinie zwischen dem Seitentitel und dem Seitenleistenmenü. Die Rahmen- und Trennlinienfarbe der Seitenleiste ist rot.

sidebar_highlight

Die Hintergrundfarbe der hervorgehobenen Zeilen in integrierten Seitenleisten

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

Eine 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 der hervorgehobenen Zeilen in den Seitenleisten.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu der in sidebar_highlight genutzten hat.

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

Eine 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 einen guten Kontrast zu der in sidebar genutzten hat.

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

Ein Nahaufnahme-Screenshot eines geöffneten Browserfensters mit einer Seitenleiste. 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 unterstützt.

Die Farbe des vertikalen Trenners der Hintergrund-Tabs.

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

Eine Nahaufnahme von Browser-Tabs zur Hervorhebung des Trennsymbol.

tab_background_text

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

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu denen bietet, die in tab_selected oder frame und frame_inactivegenutzt werden.

Beispiel ansehen
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 ausgewählten Tab-Linie.

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

tab_loading

Die Farbe des Ladeindikators und des Ladeeffekts im Tab.

Beispiel ansehen
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ß. Innerhalb des ausgewählten Tabs ist ein animierter Ladeindikator rot.

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Beim Nichtverwenden wird die Farbe des ausgewählten Tabs durch frame und frame_inactive festgelegt.

Beispiel ansehen
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 steht es für die Textfarbe des ausgewählten Tabs. Wenn tab_line nicht angegeben ist, definiert es auch die Farbe der ausgewählten Tab-Linie.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu denen bietet, die in tab_selected oder frame und frame_inactive genutzt werden.

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

Browser Firefox hat ein Insekten-Theme. Die Suchleiste ist hellgrau mit weißen Symbolen. Der Text des ausgewählten Tabs ist rot mit weißem Hintergrund.

toolbar

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

Dies setzt auch die Hintergrundfarbe der "Finden"-Leiste fest.

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

Browser Firefox ist schwarz. Die Tab-Leiste, die im Seitenbereich suchen und die URL-Leiste des Browsers sind rot mit weißem Text und Symbolen, außer für die im Seitenbereich suchen, wo der Text und das Symbol schwarz sind.

toolbar_bottom_separator

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

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

Browser Firefox ist schwarz. Die Tab-Leiste und die URL-Leiste des Browsers sind heller grau mit weißem Text und Symbolen. Eine horizontale rote Linie trennt den unteren Rand der Symbolleiste und den Anfang der Darstellung der Webseite.

toolbar_field

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

Dies setzt auch die Hintergrundfarbe des Im Seitenbereich finden-Feldes fest.

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

Browser Firefox ist schwarz. Die Tab-Leiste, die im Seitenbereich suchen und die URL-Leiste des Browsers sind heller grau mit weißem Text und Symbolen. Die Hintergrundfarbe der URL-Leiste ist rot. Die im Seitenbereich suchen ist weiß mit schwarzem Text. Das Im Seitenbereich finden-Feld ist rot mit schwarzem Text.

toolbar_field_border

Die Rahmenfarbe für Felder in der Symbolleiste.

Dies setzt auch die Rahmenfarbe des Im Seitenbereich finden-Feldes fest.

Beispiel ansehen
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 Tab-Leiste, im Seitenbereich suchen und URL-Leiste sind schwarz mit weißem Text und Symbolen. Die URL-Leiste und Im Seitenbereich finden-Felder sind rot umrandet.

toolbar_field_border_focus

Die fokussierte Rahmenfarbe für Felder in der Symbolleiste.

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

Browser Firefox ist schwarz. Die Tab-Leiste und die URL-Leiste sind schwarz mit weißem Text und Symbolen. 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 ansehen
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 Tab-Leiste, im Seitenbereich suchen und URL-Leiste 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 zur Anzeige der aktuellen Textauswahl in der URL-Leiste (und der Suchleiste, falls es konfiguriert ist, dass sie separat ist) verwendet wird.
Beispiel ansehen
json
"theme": {
  "colors": {
    "toolbar_field": "rgb(255 255 255 / 91%)",
    "toolbar_field_text": "rgb(0 100 0)",
    "toolbar_field_highlight": "rgb(180 240 180 / 90%)",
    "toolbar_field_highlight_text": "rgb(0 80 0)"
  }
}

Browser Firefox ist weiß. Die Tab-Leiste und die URL-Leiste sind weiß mit schwarzem Text und Symbolen. Die URL-Leiste 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 ein helles Grün ist, während der Text auf ein mittel-dunkles Grün mit dem toolbar_field_highlight_text gesetzt ist.

toolbar_field_highlight_text

Die Farbe, die zum Zeichnen des aktuell ausgewählten Textes in der URL-Leiste (und der Suchleiste, falls es konfiguriert ist, dass sie separat ist) verwendet wird.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu der in toolbar_field_highlight genutzten hat.

Beispiel ansehen
json
"theme": {
  "colors": {
    "toolbar_field": "rgb(255 255 255 / 91%)",
    "toolbar_field_text": "rgb(0 100 0)",
    "toolbar_field_highlight": "rgb(180 240 180 / 90%)",
    "toolbar_field_highlight_text": "rgb(0 80 0)"
  }
}

Browser Firefox ist weiß. Die Tab-Leiste und die URL-Leiste sind weiß mit schwarzem Text und Symbolen. Die URL-Leiste 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 mittel-dunkles 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 unterstützt.

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

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

Ein Screenshot eines Browserfensters mit einem geöffneten Tab. Der Browser Firefox ist schwarz. Die Tab-Leiste und die URL-Leiste sind schwarz mit Text und Symbolen in Weiß. Innerhalb der weißen URL-Leiste ist nach dem Reader-Modus-Symbol eine rote vertikale Linie, die den Rest der Symbole im URL-Leiste 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 Reader-Modus-Symbol von den anderen Symbolen trennt.

toolbar_field_text

Die Farbe des Textes in Feldern in der Symbolleiste, wie der URL-Leiste. Diese setzt auch die Farbe des Textes im Im Seitenbereich finden-Feld fest.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu der in toolbar_field genutzten hat.

Beispiel ansehen
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 Tab-Leiste und die URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Der Text in der URL-Leiste ist rot. Die Symbole und das Im Seitenbereich finden-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 einen guten Kontrast zu der in toolbar_field_focus genutzten hat.

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

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

toolbar_text

Die Farbe des Textes in der Symbolleiste. Diese setzt auch die Farbe des Textes in der "Finden"-Leiste fest.

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

Beispiel ansehen
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 Tab-Leiste, das 'im Seitenbereich finden'-Fenster und die URL-Leiste sind schwarz mit rotem Text und Symbolen. Der Text im aktiven Tab, der Navigatorleiste und der Find Mitte Leiste ist rot.

toolbar_top_separator

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

Beispiel ansehen
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 Tab-Leiste und die URL-Leiste sind schwarz mit weißem Text und Symbolen. Eine rote Linie trennt den oberen Rand der URL-Leiste vom Browser.

toolbar_vertical_separator

Die Farbe des Trennzeichens in der Lesezeichensymbolleiste. In Firefox 58 entspricht es der Farbe der Trennzeichen in der URL-Leiste.

Beispiel ansehen
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 Tab-Leiste und die URL-Leiste sind schwarz mit Text und Symbolen in Weiß. Die Farbe der vertikalen Linie, die die Symbolleiste für Lesezeichen 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 für die Kompatibilität mit Chrome bereitgestellt. Wenn ein Alias angegeben ist und die Nicht-Alias-Version ebenfalls angegeben ist, wird der Wert von 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 weniger Einträge als das additional_backgrounds-Array enthält, 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 mit "left" ausgerichtet, das vierte mit "top" und das fünfte mit "left".

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

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"

Wenn das Array weniger Einträge als das additional_backgrounds-Array enthält, 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 mit "no-repeat" gekachelt, das vierte mit "repeat-x" und das fünfte mit "no-repeat".

Wenn nicht angegeben, ist der Standardwert "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 dieselben Werte wie die CSS- background-size -Eigenschaft, wie "auto", "cover", "contain" oder explizite Breiten- und Höhenwerte (zum Beispiel, "100px 200px").

Wenn das Array weniger Einträge als das additional_backgrounds-Array enthält, 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" dimensioniert, das vierte mit "100px 100px" und das fünfte mit "auto".

Wenn nicht angegeben, ist der Standardwert "auto".

color_scheme

String

Optional

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

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

Wenn nicht angegeben, ist der Standardwert "auto".

content_color_scheme

String

Optional

Bestimmt, welches Farbschema auf die Inhalte (zum Beispiel integrierte Seiten und bevorzugtes Farbschema für Webseiten) angewendet wird. Ü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 Systemschema.

Wenn nicht angegeben, ist der Standardwert "auto".

Beispiele

Ein einfaches Theme muss ein Bild für den Header hinzufügen, die Akzentfarbe, die im Header verwendet wird, und die Farbe des Textes, der im Header verwendet wird, definieren:

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 der Firefox-Version 60 verwenden Sie ein leeres oder transparentes Headerbild, 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 auch den Header mit einem wiederholten Bild oder Bildern füllen, in diesem Fall mit einem einzelnen Bild, das in der Mitte des Headers 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 wird Ihnen einen Browser bieten, der so aussieht:

Ein Browserfenster mit zwei geöffneten Tabs und dunkler grüner Hintergrundfarbe im Kopfbereich. Der inaktive Tab hat eine weiße Textfarbe. Der aktive Tab und die Symbolleiste haben eine blaue Hintergrundfarbe mit cyanfarbigem Text. Die URL-Leiste hat einen orangenen Hintergrund mit weißen Rändern, eine grüne Textfarbe und eine weißfarbige vertikale Linienseparator. Eine rote Linie wird verwendet, um die Tabs oben zu trennen, und eine weiße Linie, um die Tabs vom Inhalt unterhalb zu trennen.

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

Dieses Beispiel (Firefox 153+) mischt Hintergrundbilder mit einem CSS-linearen 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 resultiert in:

  • background-image1.svg, das oben rechts in seiner natürlichen Größe angezeigt wird.
  • background-image2.svg, das oben links in seiner natürlichen Größe angezeigt wird.
  • Der linear-gradient, der sich von oben rechts horizontal über den Header kachelt (repeat-x) und auf 144px in der Höhe dimensioniert ist (die Breite ist automatisch). Der Gradient wechselt von Pink (#FF6BBA) oben zu Pfirsich (#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 am oberen linken Rand des Headers, und wenn das Bild den Header-Bereich 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 das Array-Format als auch das CSS-Farbformat für alle Eigenschaften akzeptiert. Davor erforderten colors/frame und colors/tab_background_text das Array-Format, während für andere Eigenschaften das CSS-Farbformat erforderlich war.