browserAction.setBadgeTextColor()
Définit la couleur du texte du badge de l'action du navigateur. Les onglets sans couleur de texte de badge spécifique hériteront de la couleur globale du texte de badge.
Syntaxe
browser.browserAction.setBadgeTextColor(
details, // object
);
Paramètres
details
-
object
color
-
La couleur, spécifiée comme l'une des couleurs :
- une chaîne : toute valeur CSS <color>, par exemple
"red"
,"#FF0000"
, ou"rgb(255,0,0)"
. Si la chaîne n'est pas une couleur valide, la promesse retournée sera rejetée et la couleur du texte ne sera pas modifiée. - Un objet
.browserAction.ColorArray
null
. Si untabId
est spécifié, il supprime la couleur du texte du badge spécifique à l'onglet afin que l'onglet hérite de la couleur globale du texte du badge. Dans le cas contraire, la couleur globale du texte du badge est ramenée à la valeur par défaut.
- une chaîne : toute valeur CSS <color>, par exemple
tabId
Facultatif-
integer
. Définit la couleur du texte du badge uniquement pour l'onglet donné. La couleur est réinitialisée lorsque l'utilisateur navigue dans cet onglet vers une nouvelle page. windowId
Facultatif-
integer
. Définit la couleur du texte du badge uniquement pour l'onglet donné.
- Si
windowId
ettabId
sont tous deux fournis, la fonction échoue et la couleur n'est pas définie. - Si
windowId
ettabId
sont tous deux omis, la couleur globale du texte du badge est définie à la place.
Exemples
Une couleur de texte de badge qui commence par le rouge et passe au vert lorsque l'on clique sur l'action du navigateur :
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });
browser.browserAction.onClicked.addListener(() => {
browser.browserAction.setBadgeTextColor({ color: "green" });
});
Définissez la couleur du texte du badge uniquement pour l'onglet actif :
browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeTextColor({ color: "red" });
browser.browserAction.onClicked.addListener((tab) => {
browser.browserAction.setBadgeTextColor({
color: "green",
tabId: tab.id,
});
});
Compatibilité des navigateurs
BCD tables only load in the browser
Note :
Cette API est basée sur l'API Chromium chrome.browserAction
. Cette documentation est dérivée de browser_action.json
dans le code de Chromium code.