Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

theme

Type Object
Obligatoire Non
Exemple
json
"theme": {
  "images": {
    "theme_frame": "images/sun.jpg"
  },
  "colors": {
    "frame": "#CF723F",
    "tab_background_text": "black"
  }
}

Utilisez la clé theme pour définir un thème statique à appliquer à Firefox. Lorsqu'elle est fournie seule, elle définit le thème utilisé lorsque Firefox utilise les schémas de couleurs claires ou sombres. Si la clé dark_theme est fournie, cette clé définit le thème utilisé lorsque Firefox utilise le schéma de couleurs clair.

Note : Si vous voulez inclure un thème avec une extension, veuillez voir l'API theme.

Note : Depuis mai 2019, les thèmes doivent être signés pour être installés (bogue Firefox 1545109 (angl.)). Voir Signature et distribution de votre extension (angl.) pour plus de détails.

Formats des images

Les formats d'image suivants sont pris en charge dans toutes les propriétés de l'image du thème :

  • JPEG
  • PNG
  • APNG
  • SVG (SVG animé est pris en charge à partir de Firefox 59)
  • GIF (Le GIF animé n'est pas supporté)

Syntaxe

La clé du thème est un objet qui prend les propriétés suivantes :

Nom Type Description
images Objet

Facultatif à partir de Firefox 60. Obligatoire avant Firefox 60.

Un objet JSON dont les propriétés représentent les images à afficher dans différentes parties du navigateur. Voir les images pour plus de détails sur les propriétés que cet objet peut contenir.

colors Objet

Obligatoire.

Un objet JSON dont les propriétés représentent les couleurs de différentes parties du navigateur. Voir colors pour plus de détails sur les propriétés que cet objet peut contenir.

properties Objet

Optionnel

Cet objet possède des propriétés qui affectent la manière dont les éléments "additional_backgrounds" sont affichés et comment les schémas de couleurs sont appliqués. Voir properties pour plus de détails sur les propriétés que cet objet peut contenir.

images

Toutes les URL sont relatives au fichier manifest.json et ne peuvent pas référencer une URL externe.

Les images doivent avoir une hauteur de 200 pixels pour garantir qu'elles remplissent toujours l'espace d'en-tête verticalement.

Nom Type Description
theme_frame String ou Object

Une image de premier plan de l'UA (définie par le chemin vers un actif d'image inclus dans l'extension) ou un dégradé CSS à ajouter à la zone d'en-tête et ancrée dans le coin supérieur droit de la zone d'en-tête. Les dégradés CSS sont pris en charge à partir de Firefox 153.

Note : Chrome ancre l'image dans le coin supérieur gauche de l'en-tête et si l'image ne remplit pas la zone de l'en-tête, l'image est en mosaïque.

Optionnel dans Firefox pour ordinateur de bureau à partir de la version 60.

additional_backgrounds Array de String ou Object

Attention : La propriété additional_backgrounds est expérimentale. Il est actuellement accepté dans les versions finale de Firefox, mais son comportement est sujet à changement.

Un tableau d'éléments d'arrière-plan supplémentaires, chacun étant soit le chemin vers un actif d'image inclus dans l'extension, soit un dégradé CSS, à ajouter à la zone d'en-tête et affiché derrière l'élément "theme_frame":. Ces éléments d'arrière-plan supplémentaires superposent le premier élément du tableau en haut et le dernier élément en bas. Les dégradés CSS sont pris en charge à partir de Firefox 153.

Optionnel

Par défaut, tous les éléments sont ancrés dans le coin supérieur droit de la zone d'en-tête, mais leur alignement, leur répétition et leur comportement de taille, ainsi que la zone de la fenêtre du navigateur dans laquelle ils sont dessinés, peuvent être contrôlés par "properties":.

Comme les éléments d'arrière-plan supplémentaires s'affichent derrière l'élément theme_frame, si theme_frame est défini comme un dégradé CSS, tous les éléments d'arrière-plan supplémentaires sont masqués.

Syntaxe de dégradé CSS

Un dégradé CSS est défini sous forme d'objet de la manière suivante { "GRADIENT_TYPE": "GRADIENT_PARAMS" }, où :

  • GRADIENT_TYPE est une valeur :
    • linear-gradient
    • radial-gradient
    • conic-gradient
    • repeating-linear-gradient
    • repeating-radial-gradient
    • repeating-conic-gradient
  • GRADIENT_PARAMS contient les paramètres de cette fonction de dégradé CSS, comme décrit dans valeurs de dégradé CSS.

colors

Ces propriétés définissent les couleurs utilisées pour les différentes parties du navigateur. Elles sont toutes facultatives. Voici comment ces propriétés influencent l'interface utilisateur de Firefox :

Aperçu des propriétés de couleur et de leur application aux composants de l'interface utilisateur de Firefox

Note : Lorsqu'un composant est affecté par plusieurs propriétés de couleur, les propriétés sont listées par ordre de priorité.

Toutes ces propriétés peuvent être définies soit sous forme de chaîne de caractères contenant une valeur de couleur CSS valide (y compris hexadécimale), soit sous forme de tableau RVB, par exemple "tab_background_text": [ 107 , 99 , 23 ].

Nom Description
bookmark_text

La couleur du texte et des icônes dans le signet et les barres de recherche. De plus, si tab_text n'est pas défini, il définit la couleur du texte de l'onglet actif et si les icons ne sont pas définies, la couleur des icônes de la barre d'outils. Fourni en tant qu'alias compatible Chrome pour l'outils toolbar_text.

Note : Assurez-vous que toute couleur utilisée contraste bien avec celles utilisées dans frame et frame_inactive ou toolbar si vous utilisez cette propriété.

Là où les icons ne sont pas définis, assurez-vous également d'un bon contraste avec button_background_active et button_background_hover.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "tab_text": "white",
    "toolbar": "black",
    "bookmark_text": "red"
  }
}

Le navigateur Firefox est noir. L'onglet du navigateur est noir avec du texte blanc. La barre d'URL et la barre de recherche dans la page sont blanches avec du texte noir mais toutes les icônes du navigateur et de la barre de recherche dans la page sont rouges.

button_background_active

La couleur de l'arrière-plan des boutons de la barre d'outils.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "button_background_active": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'URL du navigateur sont gris avec du texte blanc. L'icône de personnalisation de la barre d'outils dans la barre d'URL est blanche avec un arrière-plan rouge est enfoncée et une fenêtre intrusive est ouverte affichant une courte liste de choses à ajouter à la barre d'outils telles que la bibliothèque du navigateur et les barres latérales.

button_background_hover

La couleur de l'arrière-plan des boutons de la barre d'outils au survol.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "button_background_hover": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'URL du navigateur sont gris avec du texte blanc. L'icône pour revenir à la page précédente est blanche avec un arrière-plan rouge.

icons

La couleur des icônes de la barre d'outils, à l'exclusion de celles de la barre d'outils de recherche.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans frame, frame_inactive, button_background_active, et button_background_hover.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse sont gris avec du texte blanc. La barre d'adresse et les icônes permettant d'ouvrir un nouvel onglet sont rouges. Les icônes rouges contrastent bien avec la couleur noire de l'en-tête.

icons_attention

La couleur des icônes de la barre d'outils dans l'état d'attention comme l'icône de signet étoilé ou l'icône de téléchargement terminé.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans frame, frame_inactive, button_background_active, et button_background_hover.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "icons_attention": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse sont gris avec du texte blanc. L'icône permettant d'ajouter cette page aux favoris est rouge et enfoncée, une fenêtre contextuelle ouverte nommée modifier ce favori est affichée. Lorsque l'état d'attention est activé, les icônes de la barre d'outils contrastent bien avec le fond noir de la zone d'en-tête.

frame

La couleur de l'arrière-plan de la zone d'en-tête, affichée dans la partie de l'en-tête non couverte ou visible à travers les images définies dans "theme_frame" et "additional_backgrounds".

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "red",
     "tab_background_text": "white"
  }
}

Le navigateur Firefox est rouge avec du texte blanc. Les onglets du navigateur sont d'un rouge plus clair, également avec du texte blanc. La barre d'adresse est d'un rouge très clair avec du texte noir.

frame_inactive

La couleur de l'arrière-plan de la zone d'en-tête quand la fenêtre du navigateur est inactive, affichée dans la partie de l'en-tête non couverte ou visible à travers les images définies dans "theme_frame" et "additional_backgrounds".

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "red",
     "frame_inactive": "gray",
     "tab_text": "white"
  }
}

Le navigateur Firefox est gris. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair. Le texte des onglets est blanc et les icônes de la barre d'adresse sont d'un gris plus foncé.

ntp_background

La couleur d'arrière-plan de la page du nouvel onglet.

Voir l'exemple
json
"theme": {
  "colors": {
     "ntp_background": "red"
  }
}

Firefox affiche la page d'un nouvel onglet. L'arrière-plan de la page est rouge.

ntp_card_background

La couleur d'arrière-plan de la carte de la page du nouvel onglet.

Voir l'exemple
json
"theme": {
  "colors": {
     "ntp_card_background": "red"
  }
}

Firefox affiche la page d'un nouvel onglet. Sur la page, l'arrière-plan de la barre de recherche et des boutons de raccourci est rouge.

ntp_text

La couleur du texte de la page du nouvel onglet.

Note : Assurez-vous que la couleur utilisée contraste bien avec celle utilisée dans ntp_background.

Voir l'exemple
json
"theme": {
  "colors": {
     "ntp_text": "red"
  }
}

Firefox affiche la page d'un nouvel onglet. Sur la page, le texte est en rouge.

popup

La couleur d'arrière-plan des fenêtres intrusives (telles que la liste déroulante de la barre d'adresse et les menus avec une flèche)

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'URL du navigateur sont gris plus clair avec des icônes et du texte en blanc. L'icône « Ajouter aux marque-pages » est bleue et enfoncée, une fenêtre intrusive ouverte nommée « Modifier ce marque-page » est affichée avec un arrière-plan rouge. La couleur d'arrière-plan de la fenêtre intrusive est rouge.

popup_border

La couleur de la bordure des fenêtres intrusives.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "black",
     "popup_text": "white",
     "popup_border": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair, avec des icônes et du texte en blanc. L'icône permettant d'ajouter cette page aux marque-pages est bleue et, lorsqu'on clique dessus, une fenêtre intrusive intitulée « Modifier ce marque-page » s'affiche, avec un contour rouge et un fond noir. La bordure de la fenêtre intrusive est rouge.

popup_highlight

La couleur d'arrière-plan des éléments mis en surbrillance à l'aide du clavier dans les fenêtre intrusives (tel que l'élément sélectionné dans le menu déroulant de la barre d'URL).

Note : Il est recommandé de définir popup_highlight_text pour remplacer la couleur de texte par défaut du navigateur sur différentes plateformes.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup_highlight": "red",
     "popup_highlight_text": "white"
  }
}

Capture d'écran avec Firefox en noir. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair, avec des icônes et du texte en blanc. Une fenêtre intrusive de résultats de recherche s'affiche, avec l'arrière-plan de l'élément sélectionné en rouge. La couleur d'arrière-plan de l'élément sélectionné à l'intérieur de la fenêtre intrusive est rouge.

popup_highlight_text

La couleur du texte des éléments mis en surbrillance dans les fenêtres intrusives.

Note : S'assurer que la couleur utilisée contraste bien avec celle utilisée dans popup_highlight.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup_highlight": "black",
     "popup_highlight_text": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair, avec des icônes et du texte en blanc. Une fenêtre intrusive de résultats de recherche s'affiche, dans laquelle le texte de l'élément sélectionné apparaît en rouge sur fond noir. La couleur du texte de l'élément sélectionné offre un bon contraste avec la couleur de fond noire de cet élément.

popup_text

La couleur du texte des fenêtres intrusives.

Note : S'assurer que la couleur utilisée contraste bien avec celle utilisée dans popup.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "popup": "black",
     "popup_text": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair, avec des icônes et du texte en blanc. Une fenêtre intrusive de résultats de recherche s'affiche, dans laquelle le texte des éléments apparaît en rouge sur fond noir. La couleur du texte contraste bien avec la couleur de fond noire de la fenêtre intrusive.

sidebar

La couleur de fond des barres latérales intégrées.

Voir l'exemple
json
"theme": {
  "colors": {
     "sidebar": "red",
     "sidebar_highlight": "white",
     "sidebar_highlight_text": "green",
     "sidebar_text": "white"
  }
}

Une capture d'écran en gros plan de la barre latérale ouverte d'une fenêtre de navigateur. La couleur de fond de la barre latérale est rouge.

sidebar_border

La couleur de la bordure et du séparateur de la barre latérale du navigateur.

Voir l'exemple
json
"theme": {
  "colors": {
     "sidebar_border": "red"
  }
}

Une capture d'écran en gros plan de la barre latérale des favoris du navigateur Firefox avec un séparateur horizontal rouge entre le titre de la barre latérale et le menu de la barre latérale. La couleur de la bordure et du séparateur de la barre latérale est rouge.

sidebar_highlight

La couleur d'arrière-plan des lignes en surbrillance dans les barres latérales intégrées.

Voir l'exemple
json
"theme": {
  "colors": {
     "sidebar_highlight": "red",
     "sidebar_highlight_text": "white"
  }
}

Gros plan sur la barre latérale des favoris du navigateur Firefox, avec un élément mis en évidence. La couleur d'arrière-plan d'une ligne mise en évidence dans la barre latérale est rouge, avec du texte blanc.

sidebar_highlight_text

La couleur du texte des lignes en surbrillance dans les barres latérales intégrées.

Note : S'assurer que la couleur utilisée contraste bien avec celle utilisée dans sidebar_highlight.

Voir l'exemple
json
"theme": {
  "colors": {
    "sidebar_highlight": "pink",
    "sidebar_highlight_text": "red",
  }
}

Gros plan sur la barre latérale des favoris du navigateur Firefox avec un élément mis en évidence. La couleur du texte d'une ligne mise en évidence dans la barre latérale est rouge. La couleur du texte contraste bien avec la couleur d'arrière-plan rose de la ligne mise en évidence.

sidebar_text

La couleur du texte des barres latérales intégrées.

Note : S'assurer que la couleur utilisée contraste bien avec celle utilisée dans sidebar.

Voir l'exemple
json
"theme": {
  "colors": {
     "sidebar": "red",
     "sidebar_highlight": "white",
     "sidebar_highlight_text": "green",
     "sidebar_text": "white"
  }
}

Une capture d'écran en gros plan de la barre latérale ouverte d'une fenêtre de navigateur. Le texte affiché dans la barre latérale est blanc. La couleur du texte contraste bien avec le fond rouge de la barre latérale.

tab_background_separator

Attention : tab_background_separator n'est pas pris en charge à partir de Firefox 89.

La couleur du séparateur vertical des onglets d'arrière-plan.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_background_separator": "red"
  }
}

Un gros plan sur les onglets du navigateur pour mettre en évidence le séparateur.

tab_background_text

La couleur du texte affiché dans les onglets des pages inactives. Si tab_text ou bookmark_text n'est pas définit, s'applique au texte de l'onglet actif.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans tab_selected ou frame et frame_inactive.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "white",
    "tab_background_text": "red"
  }
}

Une capture d'écran d'une fenêtre de navigateur avec un onglet ouvert. Le navigateur est noir. Les onglets et la barre d'URL du navigateur sont blancs avec des icônes rouges et du texte rouge. La couleur du texte dans l'onglet ouvert est rouge. La couleur du texte contraste bien avec la couleur de fond noire de l'onglet.

tab_line

La couleur de la ligne de l'onglet sélectionnée.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_line": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'URL du navigateur sont gris plus foncé avec des icônes gris plus clair et du texte blanc. L'onglet sélectionné a un contour rouge.

tab_loading

La couleur de l'indicateur de chargement de l'onglet et de l'effet de vague.

Voir l'exemple
json
"theme": {
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_loading": "red"
  }
}

Capture d'écran d'une fenêtre de navigateur comportant un onglet ouvert. Le navigateur est noir. Les onglets et la barre d'adresse du navigateur sont gris foncé, avec des icônes et du texte en blanc. À l'intérieur de l'onglet sélectionné, un indicateur de chargement animé est rouge.

tab_selected

La couleur de fond de l'onglet sélectionné. Lorsqu'elle n'est pas utilisée, la couleur de l'onglet sélectionné est définie par frame et frame_inactive.

Voir l'exemple
json
"theme": {
  "images": {
  "theme_frame": "weta.png"
},
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_selected": "red"
  }
}

Capture d'écran d'une fenêtre de navigateur comportant un onglet ouvert. Le navigateur est noir. Les onglets et la barre d'adresse du navigateur sont gris foncé, avec des icônes et du texte en blanc. L'onglet sélectionné présente un fond rouge et du texte en blanc.

tab_text

Depuis Firefox 59, il représente la couleur du texte de l'onglet sélectionné. Si tab_line n'est pas défini, il définit également la couleur de la ligne de tabulation sélectionnée.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans tab_selected ou frame et frame_inactive.

Voir l'exemple
json
"theme": {
  "images": {
  "theme_frame": "weta.png"
},
  "colors": {
     "frame": "black",
     "tab_background_text": "white",
     "tab_selected": "white",
     "tab_text": "red"
  }
}

Le navigateur Firefox présente un thème illustré d'un insecte. La barre d'adresse est d'un gris plus clair, avec des icônes blanches. Le texte de l'onglet sélectionné est rouge sur fond blanc.

toolbar

La couleur de fond de la barre de navigation, de la barre de signets et de l'onglet sélectionné.

Ceci définit également la couleur de fond de la barre « Rechercher ».

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "red",
    "tab_background_text": "white"
  }
}

Le navigateur Firefox est noir. L'onglet du navigateur, la barre Rechercher dans la page et la barre d'adresse sont rouges avec du texte et des icônes blancs, sauf pour la barre Rechercher dans la page où le texte et l'icône sont noirs.

toolbar_bottom_separator

La couleur de la ligne séparant le bas de la barre d'outils de la région en dessous.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar_bottom_separator": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont d'un gris plus clair, avec du texte et des icônes blancs. Une ligne rouge horizontale sépare le bas de la barre d'outils et le début de l'affichage de la page Web.

toolbar_field

La couleur d'arrière-plan des champs de la barre d'outils, comme la barre URL.

Ceci définit également la couleur de fond du champ Rechercher dans la page.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar_field": "red"
  }
}

Le navigateur Firefox est noir. Les onglets du navigateur, la barre de recherche dans la page et la barre d'adresse sont d'un gris plus clair, avec du texte et des icônes blancs. La couleur d'arrière-plan de la barre d'adresse est rouge. La barre de recherche dans la page est blanche avec du texte noir. Le champ de recherche dans la page est rouge avec du texte noir.

toolbar_field_border

La couleur de la bordure des champs de la barre d'outils.

Ceci définit également la couleur de fond du champ Rechercher dans la page.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_border": "red"
  }
}

Le navigateur Firefox est noir. Les onglets du navigateur, la recherche dans la page et la barre d'adresse sont noirs, avec du texte et des icônes blancs. La barre d'adresse et le champ de recherche dans la page sont soulignés en rouge.

toolbar_field_border_focus

La couleur de bordure pour les champs de la barre d'outils qui ont la sélection.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_border_focus": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont noirs, avec du texte et des icônes blancs. Le champ de la barre d'adresse est sélectionné et entouré d'un contour rouge.

toolbar_field_focus

La couleur de fond pour les champs de la barre d'outils qui ont la sélection, tels que la barre d'URL.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_focus": "red"
  }
}

Le navigateur Firefox est noir. Les onglets du navigateur, la recherche dans la page et la barre d'adresse sont noirs, avec du texte et des icônes blancs. Le champ de la barre d'adresse est sélectionné et a un fond rouge avec du texte blanc.

toolbar_field_highlight La couleur d'arrière-plan utilisée pour indiquer la sélection actuelle du texte dans la barre URL (et la barre de recherche, si elle est configurée pour être séparée).
Voir l'exemple
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)"
  }
}

Le navigateur Firefox est blanc. Les onglets du navigateur et la barre d'URL sont blancs avec du texte et des icônes en noir. Le champ de la barre d'URL est sélectionné et entouré en bleu et le texte de la barre d'URL est sélectionné.

Ici, le champ toolbar_field_highlight définit que la couleur de surbrillance est un vert clair, alors que le texte est réglé sur un vert foncé à vert moyen en utilisant le texte toolbar_field_highlight_text.

toolbar_field_highlight_text

La couleur utilisée pour dessiner le texte actuellement sélectionné dans la barre d'URL (et la barre de recherche, si elle est configurée comme boîte séparée).

Note : S'assurer que la couleur utilisée contraste bien avec celles utilisées dans toolbar_field_highlight.

Voir l'exemple
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)"
  }
}

Le navigateur Firefox est blanc. Les onglets du navigateur et la barre d'URL sont blancs avec du texte et des icônes en noir. Le champ de la barre d'URL est sélectionné et entouré en bleu et le texte de la barre d'URL est sélectionné.

Ici, le champ toolbar_field_highlight_text permet de régler la couleur du texte sur un vert foncé moyen foncé, tandis que la couleur de surbrillance est un vert clair.

toolbar_field_separator

Attention : toolbar_field_separator n'est pas pris en charge à partir de Firefox 89.

La couleur des séparateurs à l'intérieur de la barre d'URL. Dans Firefox 58, cela a été implémenté en tant que toolbar_vertical_separator.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field_separator": "red"
  }
}

Une capture d'écran d'une fenêtre de navigateur avec un onglet ouvert. Le navigateur Firefox est noir. Les onglets du navigateur et la barre d'URL sont noirs avec du texte et des icônes en blanc. À l'intérieur du champ de la barre d'URL blanc, après l'icône du mode lecture, une ligne verticale rouge sépare le reste des icônes de la barre d'URL. La couleur de la ligne de séparation verticale à l'intérieur de la barre d'URL est rouge.

Dans cette capture d'écran, "toolbar_vertical_separator" est la ligne verticale blanche dans la barre URL qui sépare l'icône du mode lecture des autres icônes.

toolbar_field_text

La couleur du texte dans les champs de la barre d'outils, comme la barre URL. Ceci définit également la couleur du texte dans le champ Rechercher dans la page.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans toolbar_field.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "red"
  }
}

Une capture d'écran d'une fenêtre de navigateur avec un onglet ouvert. Le navigateur est noir. Les onglets du navigateur et la barre d'URL sont noirs avec du texte et des icônes en blanc. Le texte à l'intérieur de la barre d'URL est rouge. Les icônes et le champ de recherche dans la page ont du texte rouge sur fond noir.

toolbar_field_text_focus

La couleur du texte dans les champs de la barre d'outils qui ont la sélection, tels que la barre d'URL.

Note : Assurez-vous que la couleur utilisée contraste bien avec celles utilisées dans toolbar_field_focus.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "toolbar": "black",
    "tab_background_text": "white",
    "toolbar_field": "black",
    "toolbar_field_text": "white",
    "toolbar_field_text_focus": "red"
  }
}

Le navigateur Firefox est noir. Les onglets et la barre d'adresse du navigateur sont noirs, avec du texte et des icônes blancs. Le champ de la barre d'adresse est sélectionné et entouré d'un contour rouge.

toolbar_text

La couleur du texte de la barre d'outils. Ceci définit également la couleur du texte dans la barre « Rechercher ».

Note : Pour la compatibilité avec Chrome, utilisez l'alias bookmark_text.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_text": "red"
  }
}

Capture d'écran d'une fenêtre de navigateur comportant un onglet ouvert. Le navigateur est noir. L'onglet du navigateur, la barre de recherche et la barre d'adresse sont noirs, avec du texte et des icônes rouges. Le texte affiché dans l'onglet actif, la barre de navigation et la barre de recherche est rouge.

toolbar_top_separator

La couleur de la ligne séparant le bas de la barre d'outils de la région en dessous.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_top_separator": "red"
  }
}

Capture d'écran d'une fenêtre de navigateur comportant un onglet ouvert. Le navigateur est noir. L'onglet du navigateur et la barre d'adresse sont noirs, avec du texte et des icônes blancs. Une ligne rouge sépare le haut de la barre d'adresse du navigateur.

toolbar_vertical_separator

La couleur du séparateur à côté de l'icône du menu d'application. Dans Firefox 58, il correspond à la couleur des séparateurs dans la barre d'URL.

Voir l'exemple
json
"theme": {
  "colors": {
    "frame": "black",
    "tab_background_text": "white",
    "toolbar": "black",
    "toolbar_vertical_separator": "red"
  }
}

Capture d'écran d'une fenêtre de navigateur comportant un onglet ouvert. Le navigateur est noir. L'onglet du navigateur et la barre d'adresse sont noirs, avec du texte et des icônes blancs. La couleur de la ligne verticale séparant la barre d'outils des favoris du contenu à droite est rouge.

Aliases

De plus, cette clé accepte diverses propriétés qui sont des alias de l'une des propriétés ci-dessus. Celles-ci sont fournies à des fins de compatibilité avec Chrome. Si un alias est définit et que la version non alias est également définie, la valeur est alors extraite de la version sans alias.

Nom Alias pour
bookmark_text toolbar_text

properties

Nom Type Description
additional_backgrounds_alignment

Array et String

Optionnel.

Un tableau de valeurs d'énumération définissant l'alignement de l'élément "additional_backgrounds": élément de tableau.
Les options d'alignement comprennent :

  • "bottom"
  • "center"
  • "left"
  • "right"
  • "top"
  • "center bottom"
  • "center center"
  • "center top"
  • "left bottom"
  • "left center"
  • "left top"
  • "right bottom"
  • "right center"
  • "right top".

Si le tableau contient moins d'éléments que le tableau additional_backgrounds, celui-ci est réutilisé pour les valeurs manquantes. Par exemple, si additional_backgrounds contient 5 valeurs et que additional_backgrounds_alignment contient ["left", "top"], le troisième élément d'arrière-plan est aligné à l'aide de "left", le quatrième à l'aide de "top" et le cinquième à l'aide de "left".

Si pas défini, par défaut "right top".

additional_backgrounds_tiling

Array de String

Optionnel

Un tableau de valeurs d'énumérations définissant, comme l'élément de tableau "additional_backgrounds": correspondant de répétition. Les options comprennent :

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

Si le tableau contient moins d'éléments que le tableau additional_backgrounds, celui-ci est réutilisé pour les valeurs manquantes. Par exemple, si additional_backgrounds contient 5 valeurs et que additional_backgrounds_tiling contient ["no-repeat", "repeat-x"], le troisième élément d'arrière-plan est répété à l'aide de "no-repeat", le quatrième à l'aide de "repeat-x" et le cinquième à l'aide de "no-repeat".

Si pas défini, par défaut "no-repeat".

additional_backgrounds_size

Array de String

Optionnel

Un tableau de valeurs définissant la taille de l'élément de tableau correspondant "additional_backgrounds":. Accepte les mêmes valeurs que la propriété CSS background-size, telles que "auto", "cover", "contain", ou des valeurs explicites de largeur et de hauteur (par exemple, "100px 200px").

Si le tableau contient moins d'éléments que le tableau additional_backgrounds, celui-ci est réutilisé pour les valeurs manquantes. Par exemple, si additional_backgrounds contient 5 valeurs et que additional_backgrounds_size contient ["auto", "100px 100px"], le troisième élément d'arrière-plan est dimensionné à l'aide de "auto", le quatrième à l'aide de "100px 100px" et le cinquième à l'aide de "auto".

Si pas défini, par défaut "auto".

backgrounds_area

String

Optionnel

Détermine la zone de la fenêtre du navigateur où les images d'arrière-plan et les dégradés du thème sont dessinés. Les options comprennent :

  • "auto" — Firefox choisit la zone en fonction de additional_backgrounds_alignment. Si une valeur d'alignement positionne une image d'arrière-plan au centre vertical ou en bas de la zone d'en-tête, les arrière-plans sont dessinés dans les barres d'outils supérieures. Sinon, ils sont dessinés dans la fenêtre.
  • "window" — les arrière-plans sont dessinés dans toute la fenêtre du navigateur et s'étendent ainsi derrière l'interface verticale, comme la barre latérale et les onglets verticaux.
  • "top_toolbars" — les arrière-plans sont dessinés uniquement dans les barres d'outils horizontales en haut de la fenêtre, c'est-à-dire la barre de menus, la barre d'onglets, la barre de navigation et la barre des marque-pages. L'interface verticale, comme la barre latérale, utilise plutôt la couleur frame.

Si pas défini, par défaut "auto".

color_scheme

String

Optionnel

Détermine le schéma de couleurs appliqué à l'interface du navigateur (par exemple, aux menus contextuels) et au contenu (par exemple, aux pages intégrées et au schéma de couleurs préféré pour les pages web). Les options comprennent :

  • "auto" — un schéma clair ou sombre déterminé automatiquement selon le thème.
  • "light" — un schéma clair.
  • "dark" — un schéma sombre.
  • "system" — utilise le schéma du système.

Si pas défini, par défaut "auto".

content_color_scheme

String

Optionnel

Détermine le schéma de couleurs appliqué au contenu (par exemple, aux pages intégrées et au schéma de couleurs préféré pour les pages web). Cette propriété remplace color_scheme. Les options comprennent :

  • "auto" — un schéma clair ou sombre déterminé automatiquement selon le thème.
  • "light" — un schéma clair.
  • "dark" — un schéma sombre.
  • "system" — le schéma du système.

Si pas défini, par défaut "auto".

Exemples

Un thème de base doit définir une image à ajouter à l'en-tête, la couleur d'accent à utiliser dans l'en-tête et la couleur du texte utilisée dans l'en-tête :

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

Plusieurs éléments peuvent être utilisés pour remplir l'en-tête. Avant la version 60 de Firefox, utilisez une image d'en-tête vierge ou transparente pour contrôler l'emplacement de chaque élément supplémentaire :

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

Vous pouvez également remplir l'en-tête avec une image répétée, ou des images, dans ce cas, une seule image ancrée dans le milieu du haut de l'en-tête et répétée sur le reste de l'en-tête :

json
 "theme": {
   "images": {
     "additional_backgrounds": [ "images/logo.png" ]
   },
   "properties": {
     "additional_backgrounds_alignment": [ "top" ],
     "additional_backgrounds_tiling": [ "repeat" ]
   },
   "colors": {
     "frame": "green",
     "tab_background_text": "black"
   }
 }

L'exemple suivant utilise la plupart des différentes valeurs de "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"
    }
  }

Cela vous donne un navigateur qui ressemble à ceci :

Une fenêtre de navigateur comportant deux onglets ouverts et dont la zone d'en-tête présente un fond vert foncé. L'onglet inactif affiche du texte en blanc. L'onglet actif et la barre d'outils ont un fond bleu avec du texte de couleur cyan. La barre d'adresse présente un fond orange avec des bordures blanches, du texte vert et une ligne de séparation verticale blanche. Une ligne rouge sépare les onglets en haut de la fenêtre, tandis qu'une ligne blanche sépare les onglets du contenu situé en dessous.

Dans cette capture d'écran, "toolbar_vertical_separator" est la ligne verticale blanche dans la barre d'URL divisant l'icône du mode Lecteur des autres icônes.

Le exemple suivant (Firefox 153+) mélange des arrière-plans d'images avec un dégradé linéaire CSS :

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

Cela donne :

  • background-image1.svg affichée en haut à droite, à sa taille naturelle.
  • background-image2.svg affichée en haut à gauche, à sa taille naturelle.
  • Le linear-gradient affiché depuis le coin supérieur droit, répété horizontalement sur l'en-tête (repeat-x), et dimensionné à 144px de hauteur (la largeur est automatique). Le dégradé passe du rose (#FF6BBA) en haut au pêche (#FFC999) en bas.

Le exemple suivant (Firefox 156+) restreint le dégradé d'arrière-plan aux barres d'outils horizontales en haut de la fenêtre, de sorte qu'il ne s'étende pas derrière la barre latérale ou les onglets verticaux. Sans backgrounds_area, l'alignement "right top" fait que Firefox dessine le dégradé sur toute la fenêtre :

json
"theme": {
  "images": {
    "additional_backgrounds": [
      { "linear-gradient": "to bottom, rgb(255, 0, 128), rgb(0, 128, 255)" }
    ]
  },
  "colors": {
    "frame": "#000080",
    "tab_background_text": "#ffffff"
  },
  "properties": {
    "additional_backgrounds_alignment": ["right top"],
    "additional_backgrounds_tiling": ["no-repeat"],
    "additional_backgrounds_size": ["100% 100%"],
    "backgrounds_area": "top_toolbars"
  }
}

Avec backgrounds_area défini sur "top_toolbars", la barre latérale utilise la couleur frame. Changer backgrounds_area en "window" dessine le dégradé sur toute la fenêtre, y compris derrière la barre latérale.

Compatibilité des navigateurs

Compatibilité avec Chrome

Dans Chrome :

  • colors/toolbar_text n'est pas utilisé, utilisez colors/bookmark_text à la place.

  • images/theme_frame ancre l'image en haut à gauche de l'en-tête et si l'image ne remplit pas la zone de l'en-tête, elle est répétée.

  • toutes les couleurs doivent être définies sous forme de tableau de valeurs RVB, comme ceci :

    json
    "theme": {
      "colors": {
         "frame": [255, 0, 0],
         "tab_background_text": [0, 255, 0],
         "bookmark_text": [0, 0, 255]
      }
    }
    

    À partir de Firefox 59, les deux formes, tableau et couleur CSS, sont acceptées pour toutes les propriétés. Avant cela, colors/frame et colors/tab_background_text nécessitaient la forme tableau, tandis que les autres propriétés nécessitaient la forme couleur CSS.