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