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 Schlüssel theme, um ein statisches Theme zu definieren, das auf Firefox angewendet werden soll.

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

Hinweis: Seit Mai 2019 müssen Themes signiert werden, um installiert zu werden (Firefox-Bug 1545109). Siehe Signing and distributing your add-on für weitere Details.

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

Bildformate

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

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

Syntax

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

Name Typ Beschreibung
images Object

Optional ab Firefox 60. Verpflichtend vor Firefox 60.

Ein JSON-Objekt, dessen Eigenschaften die in verschiedenen Teilen 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 von verschiedenen Teilen 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"-Bilder angezeigt werden und wie 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 Kopfbereich vertikal ausfüllen.

Name Typ Beschreibung
theme_frame String

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

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

Optional in Desktop Firefox 60 und höher. Erforderlich in Firefox für Android.

additional_backgrounds Array von String

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

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

Optional.

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

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 wie sie auf Firefox UI-Komponenten angewendet werden

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

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

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

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

  • vollständige Hexadezimalnotierung, also nur #RRGGBB. alpha und verkürzte Syntax, wie in #RGB[A], werden nicht unterstützt.
  • Funktionale Notation (RGB-Arrays) für Themes, die auf Firefox 68.2 oder später abzielen.

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

Name Beschreibung
bookmark_text

Die Farbe von Text und Symbolen in der Lesezeichen- und Suchleiste. Außerdem, wenn tab_text nicht definiert ist, setzt es die Farbe des aktiven Tabtextes 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 einen guten Kontrast zu den in frame und frame_inactive oder toolbar verwendeten Farben hat, wenn Sie diese Eigenschaft verwenden.

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

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. URL-Leiste und die 'Seite durchsuchen'-Leiste sind weiß mit schwarzem Text, aber alle Browser- und 'Seite durchsuchen'-Leistensymbole sind rot.

button_background_active

Die Farbe des Hintergrunds 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 Anpassen-Symbol der Symbolleiste in der URL-Leiste ist weiß mit einem roten Hintergrund und 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 Sidebars.

button_background_hover

Die Farbe des Hintergrunds der schwebenden Symbolleistenschaltflächen.

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

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

icons

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

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den verwendeten in frame, frame_inactive, button_background_active und button_background_hover hat.

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

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

icons_attention

Die Farbe der Symbolleistensymbole im Aufmerksamkeitszustand, wie das Stern-Symbol eines Lesezeichens oder das Symbol für abgeschlossene Downloads.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den verwendeten in frame, frame_inactive, button_background_active und button_background_hover hat.

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

Browser Firefox ist schwarz. Die Tabs und die URL-Leiste des Browsers sind grau mit weißem Text. Das Symbol 'Diese Seite als Lesezeichen speichern' ist rot und gedrückt, ein offenes Popup namens 'Lesezeichen bearbeiten' wird angezeigt. Im Aufmerksamkeitszustand kontrastieren die Symbolleistensymbole gut mit dem schwarzen Hintergrund des Kopfbereichs.

frame

Die Farbe des Hintergrunds des Kopfbereichs, angezeigt in dem Teil des Kopfs, der nicht durch das in "theme_frame" und "additional_backgrounds" spezifizierte Bild bedeckt oder sichtbar ist.

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

Browser Firefox ist rot mit weißem Text. Die Tabs des Browsers sind hellrot, 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 Kopfs, der nicht durch das in "theme_frame" und "additional_backgrounds" spezifizierte Bild bedeckt oder sichtbar ist.

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

Browser Firefox ist grau. Die Tabs und die URL-Leiste des Browsers sind hellgrau. Der Tabtext ist weiß und die URL-Leiste-Icons sind dunkelgrau.

ntp_background

Die Hintergrundfarbe der neuen Tabseite.

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

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

ntp_card_background

Die Hintergrundfarbe der Karten auf der neuen Tabseite.

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

Firefox zeigt eine neue Tabseite an. Auf der Seite ist der Hintergrund zur Suchleiste und den Shortcut-Schaltflächen rot.

ntp_text

Die Textfarbe der neuen Tabseite.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den in ntp_background und ntp_card_background verwendeten Farben hat.

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

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

popup

Die Hintergrundfarbe der Popups (wie das Dropdown-Menü der URL-Leiste und die Pfeil-Panels).

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

Browser Firefox ist schwarz. Browser-Tabs und URL-Leiste sind hellgrau mit Symbolen und Text in Weiß. Das Lesezeichen-Symbol ist blau und gedrückt, ein offenes Popup namens 'Lesezeichen bearbeiten' wird mit einem roten Hintergrund angezeigt. Die Hintergrundfarbe des Popups ist rot.

popup_border

Die Randfarbe der Popups.

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

Browser Firefox ist schwarz. Browser-Tabs und URL-Leiste sind hellgrau mit Symbolen und Text in Weiß. Das Lesezeichen-Symbol ist blau und gedrückt, ein offenes Popup namens 'Lesezeichen bearbeiten' wird mit einem roten Umriss und schwarzem Hintergrund angezeigt. Der Rand des Popups ist rot.

popup_highlight

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

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

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

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

popup_highlight_text

Die Textfarbe von markierten Elementen innerhalb von Popups.

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

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

popup_text

Die Textfarbe der Popups.

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

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 hellgrau 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 anzeigen
json
"theme": {
  "colors": {
     "sidebar": "red",
     "sidebar_highlight": "white",
     "sidebar_highlight_text": "green",
     "sidebar_text": "white"
  }
}

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

sidebar_border

Die Rand- und Trennfarbe der Browser-Seitenleiste.

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

Eine Nahaufnahme der Firefox-Browser-Lesezeichen-Seitenleiste mit einem roten horizontalen Trenner zwischen dem Seitentitel und dem Seitenmenü. Die Rand- und Trennfarbe der Seitenleiste ist rot.

sidebar_highlight

Die Hintergrundfarbe von hervorgehobenen Reihen in eingebauten Seitenleisten.

Beispiel anzeigen
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 Reihen in Seitenleisten.

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

Beispiel anzeigen
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 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 verwendeten Farbe hat.

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

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

tab_background_separator Veraltet

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

Die Farbe des vertikalen Separators der Hintergrund-Tabs.

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

Eine Nahaufnahme der Browser-Tabs zur Hervorhebung des Separators.

tab_background_text

Die Farbe des Textes in den inaktiven Seitentabs. Wenn tab_text oder bookmark_text nicht angegeben ist, wird dies für den Text des aktiven Tabs verwendet.

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den in tab_selected oder frame und frame_inactive verwendeten Farben hat.

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 dem schwarzen Hintergrund 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 dunkelgrau mit hellgrauen Symbolen und weißem Text. Der ausgewählte Tab hat eine rote Umrandung.

tab_loading

Die Farbe des Ladeindikators und der Ladeanimation im Tab.

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

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

tab_selected

Die Hintergrundfarbe des ausgewählten Tabs. Wenn nicht verwendet, wird die Farbe des ausgewählten Tabs von 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 dunkelgrau mit weißen Symbolen und weißem Text. Der ausgewählte Tab hat roten Hintergrund und weißen Text.

tab_text

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

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den in tab_selected oder frame und frame_inactive verwendeten Farben hat.

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

Browser Firefox hat ein Insektenthema. Die URL-Leiste ist 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 "Suchen"-Leiste.

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

Browser Firefox ist schwarz. Browser-Tabs, Suchleiste und URL-Leiste sind rot mit weißem Text und Symbolen, mit Ausnahme der Suchleiste, bei der Text und Symbol schwarz sind.

toolbar_bottom_separator

Die Farbe der Linie, die den unteren Rand der Symbolleiste von der darunterliegenden Region 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 hellgrau mit weißem Text und Symbolen. Eine horizontale rote Linie trennt den unteren Rand der Symbolleiste und den Beginn der Anzeige der Webseite.

toolbar_field

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

Dies setzt auch die Hintergrundfarbe des "Suchen in Seite"-Feldes.

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

Browser Firefox ist schwarz. Die Tabs, Suchleiste und URL-Leiste des Browsers sind hellgrau mit weißem Text und Symbolen. Die Hintergrundfarbe der URL-Leiste ist rot. Die Suchleiste ist weiß mit schwarzem Text. Das 'In Seite suchen' Feld ist rot mit schwarzem Text.

toolbar_field_border

Die Randfarbe für Felder in der Symbolleiste.

Dies setzt auch die Randfarbe des "Suchen in Seite"-Feldes.

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

Browser Firefox ist schwarz. Die Tabs, Suchleiste und URL-Leiste des Browsers sind schwarz mit weißem Text und Symbolen. Die Felder der URL-Leiste und der Suchleiste sind rot umrandet.

toolbar_field_border_focus

Die fokussierte Randfarbe 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 Feld der URL-Leiste 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, Suchleiste und 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 Auswahl des Textes in der URL-Leiste zu kennzeichnen (und der Suchleiste, wenn sie separat konfiguriert 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 und die URL-Leiste des Browsers sind weiß mit Text und Symbolen in Schwarz. Das Feld der URL-Leiste ist fokussiert und in Blau umrandet, und der URL-Leistentext ist markiert.

Hier 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 mittelstarkes Grün gesetzt wird.

toolbar_field_highlight_text

Die Farbe, die verwendet wird, um den derzeit in der URL-Leiste markierten Text zu zeichnen (und in der Suchleiste, wenn sie als separates Feld konfiguriert ist).

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

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

Browser Firefox ist weiß. Die Tabs und die URL-Leiste des Browsers sind weiß mit Text und Symbolen in Schwarz. Das Feld der URL-Leiste ist fokussiert und in Blau umrandet, und der URL-Leistentext ist markiert.

Hier wird mit dem Feld toolbar_field_highlight_text die Textfarbe auf ein mittelstarkes bis mittleres Dunkelgrün gesetzt, während die Hervorhebungsfarbe ein helles Grün ist.

toolbar_field_separator Veraltet

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

Die Farbe der Separatoren 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. Der 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-Leiste-Feldes, nach dem Reader-Mode-Symbol, eine rote vertikale Linie, die den Rest der URL-Leiste-Symbole 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-Mode-Symbol von den anderen Symbolen trennt.

toolbar_field_text

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

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den in toolbar_field verwendeten Farben hat.

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 'In Seite suchen'-Feld haben roten Text mit schwarzem Hintergrund.

toolbar_field_text_focus

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

Hinweis: Stellen Sie sicher, dass die verwendete Farbe einen guten Kontrast zu den in toolbar_field_focus verwendeten Farben hat.

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

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

toolbar_text

Die Farbe des Textes der Symbolleiste. Dies setzt auch die Farbe des Textes in der "Suchen"-Leiste.

Hinweis: Aus Kompatibilitätsgründen 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, Suchleiste und die URL-Leiste des Browsers sind schwarz mit rotem Text und Symbolen. Der Text innerhalb des aktiven Tabs, der Navigationsleiste und der Suchleiste ist rot.

toolbar_top_separator

Die Farbe der Linie, die den oberen Rand der Symbolleiste von der darüber liegenden Region 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 Teil der URL-Leiste vom Browser.

toolbar_vertical_separator

Die Farbe des Vertikaltrenners in der Lesezeichenleiste. In Firefox 58 entspricht es der Farbe der Separatoren 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 Lesezeichenleiste 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 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-Eintrags 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 nicht angegeben, standardmäßig "right top".

additional_backgrounds_tiling

Array von String

Optional

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

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

Wenn nicht angegeben, standardmäßig "no-repeat".

color_scheme

String

Optional

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

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

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

content_color_scheme

String

Optional

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

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

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

Beispiele

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

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

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

json
 "theme": {
   "images": {
     "additional_backgrounds": [ "images/left.png", "images/middle.png", "images/right.png"]
   },
   "properties": {
     "additional_backgrounds_alignment": [ "left top", "top", "right top"]
   },
   "colors": {
     "frame": "blue",
     "tab_background_text": "white"
   }
 }

Sie können den Header auch mit einem wiederholten Bild oder Bildern füllen, in diesem Fall ein einzelnes Bild, das in der Mitte oben 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 ermöglicht Ihnen einen Browser, der folgendermaßen aussieht:

Ein Browserfenster mit zwei geöffneten Tabs und dunkelgrünem Hintergrund im Kopfbereich. Der inaktive Tab hat weiße Textfarbe. Der aktive Tab und die Symbolleiste haben eine blaue Hintergrundfarbe mit cyanfarbener Schrift. Die URL-Leiste hat einen orangefarbenen Hintergrund mit weißen Rändern, grüner Textfarbe und einer weißen vertikalen Linien Trennlinie. Eine rote Linie trennt die Tabs oben und eine weiße Linie trennt die Tabs vom darunterliegenden Inhalt.

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.

Browser-Kompatibilität

Chrome-Kompatibilität

In Chrome:

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

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

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

    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.