Spec-Zone.ru › Web Extensions

action.onClicked

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

Примечание: Этот API доступен в Manifest V3 или более поздних версиях.

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

Синтаксис

browser.action.onClicked.addListener(listener)
browser.action.onClicked.removeListener(listener)
browser.action.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 использует его для отображения контекстного меню перед срабатыванием этого события.

Примеры

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

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

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

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
onClicked 88 88 109 ? 74 Нет ? ? 109 ? Нет ?

Примечание: Этот API основан на API chrome.action 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/action/onClicked

Spec-Zone.ru

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