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 zu definieren, das in Firefox angewendet wird. Wenn es allein bereitgestellt wird, definiert es das Theme, das verwendet wird, wenn Firefox entweder das helle oder das dunkle Farbschema verwendet. Wenn der dark_theme-Schlüssel bereitgestellt wird, liefert dieser Schlüssel das Theme, das verwendet wird, wenn Firefox das helle Farbschema verwendet.

Hinweis: Wenn Sie ein Theme mit einer Erweiterung einfügen möchten, sehen Sie bitte die theme API.

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

Bildformate

Folgende 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 folgende Eigenschaften annimmt:

Name Typ Beschreibung
images Object

Optional ab Firefox 60. Vor Firefox 60 verpflichtend.

Ein JSON-Objekt, dessen Eigenschaften die im Browser anzuzeigenden Bilder darstellen. Weitere Informationen zu den Eigenschaften, die dieses Objekt enthalten kann, finden Sie unter images.

colors Object

Verpflichtend

Ein JSON-Objekt, dessen Eigenschaften die Farben verschiedener Teile des Browsers darstellen. Weitere Informationen zu den Eigenschaften, die dieses Objekt enthalten kann, finden Sie unter colors.

properties Object

Optional

Dieses Objekt hat Eigenschaften, die beeinflussen, wie die "additional_backgrounds"-Elemente angezeigt werden und wie Farbschemata angewendet werden. Weitere Informationen zu den Eigenschaften, die dieses Objekt enthalten kann, finden Sie unter properties.

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 Headerbereich immer vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String oder Object

Ein Vordergrundbild (definiert durch den Pfad zu einem in der Erweiterung verpackten Bildasset) oder CSS-Verlauf, das dem Headerbereich hinzugefügt und an der oberen rechten Ecke des Headerbereichs verankert wird. CSS-Verläufe werden ab Firefox 153 unterstützt.

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

Optional in Desktop-Firefox ab Version 60.

additional_backgrounds Array von String oder Object

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

Ein Array von zusätzlichen Hintergrundelementen, die jeweils entweder der Pfad zu einem in der Erweiterung verpackten Bildasset oder CSS-Verlauf sind und dem Headerbereich hinzugefügt werden, hinter dem "theme_frame":-Element angezeigt werden. Diese zusätzlichen Hintergrundelemente schichten das erste Element im Array oben und das letzte Element unten. CSS-Verläufe werden ab Firefox 153 unterstützt.

Optional

Standardmäßig werden alle Elemente an der oberen rechten Ecke des Headerbereichs verankert, aber ihre Ausrichtung, Wiederholung und Größenverhalten können über "properties": kontrolliert werden.

Da zusätzliche Hintergrundelemente hinter dem theme_frame-Element angezeigt werden, werden alle zusätzlichen Hintergrundelemente ausgeblendet, wenn theme_frame als CSS-Verlauf festgelegt ist.

CSS-Verlaufssyntax

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

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

colors

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

Übersicht der Farbeigenschaften und wie sie auf Firefox-UI-Komponenten angewendet werden

Hinweis: Wo ein Element von mehreren Farbeigenschaften betroffen ist, werden die Eigenschaften in der Reihenfolge ihrer Priorität aufgelistet.

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

Name Beschreibung
bookmark_text

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

Hinweis: Stellen Sie sicher, dass jede verwendete Farbe in gutem Kontrast zu den in frame und frame_inactive oder toolbar verwendeten Farben steht, 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 ansehen
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "tab_text": "white",
    "toolbar": "black",
    "bookmark_text": "red"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarte des Browsers ist schwarz mit weißem Text. Die URL-Leiste und die Suchleiste sind weiß mit schwarzem Text, aber alle Symbole der Browser- und der 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"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind grau mit weißem Text. Das Symbol 'Symbolleiste anpassen' in der URL-Leiste mit einem weißen Icon und rotem Hintergrund ist gedrückt und ein Popup wird geöffnet, das eine kurze Liste von Dingen anzeigt, die zur Symbolleiste hinzugefügt werden können, wie 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"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind grau mit weißem Text. Das Symbol, um eine Seite zurückzugehen, ist weiß mit einem roten Kreis als Hintergrund.

icons

Die Farbe der Symbole in der Symbolleiste, ausgenommen der in der Suchleiste.

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

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

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

icons_attention

Die Farbe der Aufmerksamkeitssymbole in der Symbolleiste, wie das Stern-Lesezeichensymbol oder das beendete Downloads-Symbol.

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

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

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind grau mit weißem Text. Das Lesezeichen dieses Seiten-Symbol ist rot und gedrückt, ein geöffnetes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt. Während sich die Symbole in der Aufmerksamkeit befinden, kontrastieren sie gut mit dem schwarzen Hintergrund des Headerbereichs.

frame

Die Farbe des Hintergrunds des Headerbereichs, sichtbar in dem Teil des Headers, der nicht von den in "theme_frame" und "additional_backgrounds" spezifizierten Elementen abgedeckt oder durchschaut wird.

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

Der Firefox-Browser ist rot mit weißem Text. Die Registerkarten 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 Headerbereichs, wenn das Browserfenster inaktiv ist, sichtbar in dem Teil des Headers, der nicht von den in "theme_frame" und "additional_backgrounds" spezifizierten Elementen abgedeckt oder durchschaut wird.

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

Der Firefox-Browser ist grau. Die Registerkarten und die URL-Leiste des Browsers sind heller grau. Der Tabtext ist weiß und das URL-Leistensymbol ist dunkler grau.

ntp_background

Die Hintergrundfarbe der neuen Tab-Seite.

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

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

ntp_card_background

Die Hintergrundfarbe der Karten auf der neuen Tab-Seite.

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

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

ntp_text

Die Textfarbe der neuen Tab-Seite.

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

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

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

popup

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

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

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in weiß. Das Lesezeichen diese Seite-Symbol ist blau und gedrückt, ein geöffnetes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt, mit einem roten Hintergrund. Die Hintergrundfarbe des Popups ist rot.

popup_border

Die Randfarbe der Popups.

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

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in weiß. Das Lesezeichen diese Seite-Symbol ist blau und gedrückt, ein geöffnetes Popup mit dem Namen 'Dieses Lesezeichen bearbeiten' wird angezeigt mit einem roten Umriss und schwarzen Hintergrund. Der Rand des Popups ist rot.

popup_highlight

Die Hintergrundfarbe von mit der Tastatur hervorgehobenen Elementen in Popups (wie das ausgewählte Element im Dropdown-Menü 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"
  }
}

Ein Screenshot von Firefox in Schwarz. Die Registerkarten und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in weiß. Ein Suchergebnisse-Popup wird angezeigt mit einem hervorgehobenen Element, dessen Hintergrund rot ist. Die Hintergrundfarbe des hervorgehobenen Elements innerhalb des Popups ist rot.

popup_highlight_text

Die Textfarbe von hervorgehobenen Elementen innerhalb von Popups.

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

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

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in weiß. Ein Suchergebnisse-Popup wird angezeigt mit einem hervorgehobenen Element, dessen Text rot mit einem schwarzen Hintergrund ist. Die Textfarbe des hervorgehobenen Elements kontrastiert gut mit der schwarzen Hintergrundfarbe des Elements.

popup_text

Die Textfarbe von Popups.

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

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

Der Firefox-Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind heller grau mit Symbolen und Text in weiß. Ein Suchergebnisse-Popup wird angezeigt mit Text in rot. 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-Bild einer geöffneten Seitenleiste in einem Browserfenster. Die Hintergrundfarbe der Seitenleiste ist rot.

sidebar_border

Die Farbe des Rahmens und der Trennlinie der Browser-Seitenleiste

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

Eine Nahaufnahme der Firefox-Browser-Lesezeichen-Seitenleiste mit einem roten horizontalen Trennzeichen zwischen dem Titel der Seitenleiste und dem Menü der Seitenleiste. Die Farbe des Rahmens und der Trennlinie der Seitenleiste ist rot.

sidebar_highlight

Die Hintergrundfarbe von hervorgehobenen Zeilen in integrierten Seitenleisten

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

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

sidebar_highlight_text

Die Textfarbe von hervorgehobenen Zeilen in Seitenleisten.

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

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

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

sidebar_text

Die Textfarbe von Seitenleisten.

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

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

Ein Nahaufnahme-Bild einer geöffneten Seitenleiste in einem Browserfenster. 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 Trennzeichens im Hintergrund der Registerkarten.

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

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

tab_background_text

Die Farbe des Textes, der in den inaktiven Registerkarten angezeigt wird. Wenn tab_text oder bookmark_text nicht angegeben ist, gilt für den aktiven Registerkartentext.

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

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

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

tab_line

Die Farbe der Linie der ausgewählten Registerkarte.

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

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

tab_loading

Die Farbe des Ladeindikators der Registerkarte und des Ladeimpulses der Registerkarte.

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

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

tab_selected

Die Hintergrundfarbe der ausgewählten Registerkarte. Wenn es nicht verwendet wird, wird die Farbe der ausgewählten Registerkarte 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 einer geöffneten Registerkarte. Der Browser ist schwarz. Die Registerkarten und die URL-Leiste des Browsers sind dunkler grau mit Symbolen und Text in weiß. Die ausgewählte Registerkarte hat einen roten Hintergrund und weißen Text.

tab_text

Ab Firefox 59 repräsentiert es die Textfarbe der ausgewählten Registerkarte. Wenn tab_line nicht angegeben ist, definiert es auch die Farbe der Linie der ausgewählten Registerkarte.

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

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

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

toolbar

Die Hintergrundfarbe für die Navigationsleiste, die Lesezeichenleiste und die ausgewählte Registerkarte.

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

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

Der Firefox-Browser ist schwarz. Die Registerkarte, die Suchleiste des Browsers und die URL-Leiste sind rot mit weißem Text und Symbolen, mit Ausnahme der Suchleiste, in der der Text und das Symbol schwarz sind.

toolbar_bottom_separator

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

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

Der Firefox-Browser ist schwarz. Die Registerkarte 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 Webseitenanzeige.

toolbar_field

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

Dies legt auch die Hintergrundfarbe des Suchen innerhalb der Seite Felds fest.

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

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

toolbar_field_border

Die Randfarbe für Felder in der Symbolleiste.

Dies legt auch die Randfarbe des Suchen innerhalb der Seite Felds 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"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarte, die Suchleiste und die URL-Leiste des Browsers sind schwarz mit weißen Texten und Symbolen. Die URL-Leiste und die Suchfelder sind rot umrandet.

toolbar_field_border_focus

Die Randfarbe der markierten 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"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit weißen Texten und Symbolen. Das URL-Leistenfeld ist fokussiert und rot umrandet.

toolbar_field_focus

Die Hintergrundfarbe der fokussierten 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"
  }
}

Der Firefox-Browser ist schwarz. Die Registerkarte, die Suchleiste und die URL-Leiste des Browsers sind schwarz mit weißen Texten und Symbolen. Die Hintergrundfarbe der fokussierten URL-Leiste ist rot und der Text ist weiß.

toolbar_field_highlight Die Hintergrundfarbe zur Hervorhebung der aktuellen Textauswahl in der URL-Leiste (und der Suchleiste, falls diese separat konfiguriert ist).
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)"
  }
}

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

Hierbei gibt das Feld toolbar_field_highlight an, dass die Hervorhebungsfarbe ein helles Grün ist, während der Text mit toolbar_field_highlight_text auf ein dunkel-mittleres Grün gesetzt wird.

toolbar_field_highlight_text

Die Farbe zum Zeichnen von Texten, die derzeit in der URL-Leiste ausgewählt sind (und der Suchleiste, falls diese als separate Box konfiguriert ist).

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

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

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

Hierbei wird das Feld toolbar_field_highlight_text verwendet, um die Textfarbe auf ein dunkel-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 unterstützt.

Die Farbe der Trennzeichen innerhalb 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 einer offenen Registerkarte. Der Firefox-Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit Texten und Symbolen in weiß. Innerhalb des weißen URL-Leistenfeldes befindet sich nach dem Lesemodus-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 Lesemodus-Symbol von den anderen Symbolen trennt.

toolbar_field_text

Die Farbe des Textes in Feldern der Symbolleiste, wie der URL-Leiste. Dies legt auch die Farbe des Textes im Suchen innerhalb der Seite Feld fest.

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

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 einer offenen Registerkarte. Der Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit weißen Texten und Symbolen. Der Text in der URL-Leiste ist rot. Die Symbole und das Suchfeld haben roten Text mit schwarzem Hintergrund.

toolbar_field_text_focus

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

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

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 offenen Registerkarten. Der Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit Texten und Symbolen in weiß. Die URL-Leiste hat den Fokus; der Text und die Symbole 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 "Suchen"-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 einer offenen Registerkarte. Der Browser ist schwarz. Die Registerkarte, die Suchleiste und die URL-Leiste des Browsers sind schwarz mit rotem Text und Symbolen. Der Text in der aktiven Registerkarte, der Navigationsleiste und der Suchleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die den oberen Rand der Symbolleiste von dem Bereich 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 einer offenen Registerkarte. Der Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit weißen Texten und Symbolen. Eine rote Linie trennt den oberen Teil der URL-Leiste vom Browser.

toolbar_vertical_separator

Die Farbe des Trennzeichens im Lesezeichentoolbar. In Firefox 58 entspricht dies der Farbe der Trennzeichen innerhalb 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 einer offenen Registerkarte. Der Browser ist schwarz. Die Registerkarte und die URL-Leiste des Browsers sind schwarz mit Texten und Symbolen in weiß. Die Farbe der vertikalen Linie, die die Lesezeichentoolbar von dem Inhalt rechts trennt, ist rot.

Aliases

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 Nicht-Alias-Version ebenfalls gegeben 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 Elemente 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, wird standardmäßig "right top" verwendet.

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 Elemente 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, wird standardmäßig "no-repeat" verwendet.

additional_backgrounds_size

Array von String

Optional

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

Wenn das Array weniger Elemente 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" skaliert, das vierte mit "100px 100px", und das fünfte mit "auto".

Wenn nicht angegeben, wird standardmäßig "auto" verwendet.

color_scheme

String

Optional

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

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

Wenn nicht angegeben, wird standardmäßig "auto" verwendet.

content_color_scheme

String

Optional

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

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

Wenn nicht angegeben, wird standardmäßig "auto" verwendet.

Beispiele

Ein einfaches Theme muss ein Bild definieren, das dem Header hinzugefügt wird, die Akzentfarbe, die im Header verwendet wird, und die Farbe des Textes, der 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 Version 60 von Firefox 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 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 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"
    }
  }

Dies ergibt einen Browser, der so aussieht:

Ein Browserfenster mit zwei geöffneten Registerkarten und dunkelgrüner Hintergrundfarbe im Headerbereich. Die inaktive Registerkarte hat eine weiße Textfarbe. Die aktive Registerkarte und die Symbolleiste haben eine blaue Hintergrundfarbe mit zyanfarbenem Text. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rändern, eine grüne Textfarbe und eine weiße senkrechte Trennungslinie. Eine rote Linie wird verwendet, um die Registerkarten oben zu trennen, und eine weiße Linie, um die Registerkarten vom darunterliegenden Inhalt zu trennen.

In diesem Screenshot ist "toolbar_vertical_separator" die weiße vertikale Linie in der URL-Leiste, die das Lesezeichen-Symbol vom Rest der Symbole trennt.

Dieses Beispiel (Firefox 153+) kombiniert Bildhintergründe mit einem CSS-Linearverlauf:

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, das oben rechts in der natürlichen Größe angezeigt wird.
  • background-image2.svg, das oben links in der natürlichen Größe angezeigt wird.
  • Der linear-gradient, der von oben rechts gekachelt horizontal über den Header (repeat-x) zeigt und auf 144 Pixel Höhe skaliert wird (die Breite ist automatisch). Der Verlauf wechselt von Rosa (#FF6BBA) am oberen Teil zu Pfirsich (#FFC999) am unteren Teil.

Browser-Kompatibilität

Chrome Kompatibilität

In Chrome:

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

  • images/theme_frame verankert das Bild oben links im Header und kachelt das Bild, wenn es den Headerbereich nicht ausfüllt.

  • Alle Farben müssen als Array von RGB-Werten angegeben werden, wie in folgendem Beispiel:

    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.