Дополнения

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

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Обычно это browser action, этот параметр пользовательского интерфейса - кнопка, добавленная в панель инструментов браузера. Пользователи нажимают кнопку, чтобы взаимодействовать с вашим расширением.

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

Сравните с address bar button, которая предлагает аналогичное поведение, но используется в ситуациях, когда расширение должно быть доступно только на определенных страницах.

Указание действия браузера

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

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

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

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

browser.browserAction.onClicked.addListener(handleClick);

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

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

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

Примеры

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

  • bookmark-it использует действие браузера без всплывающего окна.
  • beastify использует действие браузера со всплывающим окном.

Метки документа и участники

 Внесли вклад в эту страницу: Shychara
 Обновлялась последний раз: Shychara,