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. -
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