Кнопка панели инструментов

Обычно называемая действием браузера, эта опция пользовательского интерфейса представляет собой кнопку, добавленную в панель инструментов браузера. Пользователи нажимают кнопку, чтобы взаимодействовать с вашим расширением. A custom browser action icon it the browser tool bar that looks like paw print.

Кнопка панели инструментов (действие браузера) очень похожа на кнопку адресной строки (действие страницы). Различия и рекомендации по тому, когда использовать что, см. в разделе Действия страницы и действия браузера.

Определение действия браузера

Вы определяете свойства действия браузера, используя ключ browser_action в файле manifest.json:

"browser_action": {
  "default_icon": {
    "19": "button/geo-19.png",
    "38": "button/geo-38.png"
  },
  "default_title": "Whereami?"
}

Единственный обязательный ключ — default_icon.

Существует два способа определения действия браузера: с поп-ап или без него. Если вы не укажете поп-ап, при нажатии пользователем на кнопку будет отправлено событие расширению, на которое оно реагирует с помощью browserAction.onClicked:

browser.browserAction.onClicked.addListener(handleClick);

Если вы укажете поп-ап, событие клика не отправляется: вместо этого, при нажатии пользователем на кнопку, отображается поп-ап. Пользователь может взаимодействовать с поп-апом, а он автоматически закрывается, когда пользователь кликает вне его. Более подробную информацию о создании и управлении поп-апами см. в статье Поп-ап.

Обратите внимание, что ваше расширение может иметь только одно действие браузера.

Вы можете изменить многие свойства действия браузера программно, используя API browserAction.

Иконки

Подробную информацию о том, как создавать иконки для использования с действием браузера, см. в разделе Иконография в документации Системы дизайна Acorn.

Примеры

В репозитории webextensions-examples на GitHub представлены два примера расширений, реализующих действия браузера:

bookmark-it использует действие браузера без поп-апа
beastify использует действие браузера с поп-апом

© 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/user_interface/Browser_action