Spec-Zone.ru › Web Extensions

browserAction.onClicked

Срабатывает при щелчке по значку действия браузера. Данное событие не будет срабатывать, если действие браузера имеет всплывающее окно.

Для определения действия правой кнопкой мыши используйте API contextMenus с типом контекста «browser_action» context type.

Синтаксис

browser.browserAction.onClicked.addListener(listener)
browser.browserAction.onClicked.removeListener(listener)
browser.browserAction.onClicked.hasListener(listener)

События имеют три функции:

addListener(listener)

Добавляет обработчик события.

removeListener(listener)

Прекращает прослушивание события. Аргумент listener — это обработчик, который нужно удалить.

hasListener(listener)

Проверяет, зарегистрирован ли обработчик listener для данного события. Возвращает true, если обработчик зарегистрирован, false, в противном случае.

Синтаксис addListener

Параметры

callback

Функция, которая будет вызвана при возникновении события. Функции будут переданы следующие аргументы:

tab

tabs.Tab. Вкладка, активная при нажатии на значок.

OnClickData

Объект, содержащий информацию о щелчке.

modifiers

array. Модификаторы клавиатуры, активные во время щелчка, могут быть одним или несколькими из Shift, Alt, Command, Ctrl, или MacCtrl.

button

integer. Указывает кнопку, использованную для щелчка по значку страницы-действия: 0 для левой кнопки или щелчка, не связанного с мышкой (например, с клавиатуры), и 1 для щелчка средней кнопкой или колесиком мыши. Следует отметить, что щелчок правой кнопкой мыши не поддерживается, так как Firefox использует его для отображения контекстного меню до срабатывания данного события.

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
OnClickData Нет Нет 72 ? Нет Нет ? ? 79 ? Нет ?
onClicked Да 14 45 ? Да 14 ? ? 55 ? 15 ?
tab Да 14 45 ? Да 14 ? ? 55 ? 15 ?

Примеры

При нажатии пользователем на значок отключите его для активной вкладки и выведите URL вкладки:

browser.browserAction.onClicked.addListener((tab) => {
  // disable the active tab
  browser.browserAction.disable(tab.id);
  // requires the "tabs" or "activeTab" permission, or host permissions for the URL
  console.log(tab.url);
});

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

  • bookmark-it
  • favourite-colour
  • find-across-tabs
  • forget-it
  • google-userinfo
  • native-messaging
  • open-my-page-button
  • permissions
  • runtime-examples
  • store-collected-images

Примечание:

Этот 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/onClicked

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API