browserAction.setBadgeBackgroundColor()

Устанавливает цвет фона для значка. Вкладки без определенного цвета фона значка будут наследовать глобальный цвет фона значка, который по умолчанию равен [217, 0, 0, 255] в Firefox.

Начиная с Firefox 63, если цвет текста значка не задан явно с помощью browserAction.setBadgeTextColor(), то цвет текста значка будет автоматически настроен на черный или белый для максимального контраста со заданным цветом фона значка. Например, если вы установите цвет фона значка на белый, то цвет текста значка по умолчанию будет настроен на черный, и наоборот.

В других браузерах всегда используется белый цвет текста, поэтому для обеспечения читаемости текста предпочтительнее установить темный фон.

Синтаксис

browser.browserAction.setBadgeBackgroundColor(
  details // object
)

Параметры

details

Объект со следующими свойствами:

color

Цвет, заданный как один из:

строка: любое значение CSS <цвет>, например "red", "#FF0000", или "rgb(255,0,0)". Если строка не является допустимым цветом, возвращаемое обещание будет отклонено, и цвет фона не будет изменён.
объект browserAction.ColorArray.
null. Если задан tabId, он удаляет цвет фона значка, специфичный для вкладки, так что вкладка наследует глобальный цвет фона значка. В противном случае глобальный цвет фона значка сбрасывается до значения по умолчанию.

tabId Необязательно

integer. Устанавливает цвет фона значка только для данной вкладки. Цвет сбрасывается, когда пользователь переходит на новую страницу в этой вкладке.

windowId Необязательно

integer. Устанавливает цвет фона значка только для данной вкладки.

Если windowId и tabId оба указаны, функция завершается ошибкой, и цвет не устанавливается.
Если windowId и tabId оба отсутствуют, устанавливается глобальный цвет фона значка.

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`setBadgeBackgroundColor`	Да	14	45 45–58 Цвет фона значка, специфичный для вкладки, не очищается при загрузке новой страницы.	?	Да	14 API существует, но не имеет эффекта.	?	?	79	?	15 API существует, но не имеет эффекта.	?
`details_windowId_parameter`	Нет	Нет	62	?	Нет	Нет	?	?	Нет	?	Нет	?
`null`	Нет	Нет	59	?	Нет	Нет	?	?	79	?	Нет	?
`string`	Да	79	Да До Firefox 59, недопустимые строки цвета работали как `null`.	?	Да	Нет	?	?	79	?	Нет	?

Цвет по умолчанию в Firefox: [217, 0, 0, 255].

Примеры

Цвет фона, который начинает как красный, и становится зеленым при нажатии на действие браузера:

browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeBackgroundColor({ color: "red" });

browser.browserAction.onClicked.addListener(() => {
  browser.browserAction.setBadgeBackgroundColor({ color: "green" });
});

Установить цвет фона значка только для активной вкладки:

browser.browserAction.setBadgeText({ text: "1234" });
browser.browserAction.setBadgeBackgroundColor({ color: "red" });

browser.browserAction.onClicked.addListener((tab) => {
  browser.browserAction.setBadgeBackgroundColor({
    color: "green",
    tabId: tab.id,
  });
});

Примеры расширений

tabs-tabs-tabs

Примечание: Это API основано на API chrome.browserAction Chromium. Данная документация взята из browser_action.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/browserAction/setBadgeBackgroundColor