pageAction.onClicked
Вызывается при щелчке по значку действия на странице. Это событие не будет вызвано, если у действия на странице есть всплывающее окно.
Для определения действия при правом щелчке используйте API contextMenus с типом контекста «page_action» context type.
Синтаксис
browser.pageAction.onClicked.addListener(listener) browser.pageAction.onClicked.removeListener(listener) browser.pageAction.onClicked.hasListener(listener)
События имеют три функции:
addListener(callback)-
Добавляет обработчик этого события.
removeListener(listener)-
Прекращает прослушивание этого события. Аргумент
listener— это обработчик, который нужно удалить. hasListener(listener)-
Проверяет, зарегистрирован ли
listenerдля этого события. Возвращаетtrueв случае прослушивания,falseв противном случае.
Синтаксис addListener
Параметры
callback-
Функция, которая будет вызвана при возникновении этого события. Функция получает следующие аргументы:
tab-
Объект
tabs.Tab, представляющий вкладку, на которой был нажат значок действия на странице. OnClickData-
Объект, содержащий информацию о нажатии.
modifiers-
Объект. Модификаторы клавиатуры, активные в момент нажатия, один или несколько из
Shift,Alt,Command,Ctrl, илиMacCtrl. -
Число. Указывает кнопку, используемую для нажатия значка действия на странице:
0для левой кнопки мыши или нажатия, не связанного с мышкой, например, из клавиатуры, и1для нажатия средней кнопки или колёсика. Обратите внимание, что правое нажатие не поддерживается, так как Firefox потребляет его для отображения контекстного меню до срабатывания этого события.
Совместимость с браузерами
| Рабочий стол | Мобильная версия | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
OnClickData |
Нет | Нет | 72 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
onClicked |
Да | 14 | 45 | ? | Да | 14 | ? | ? | 50 | ? | 15 | ? |
tab |
Да | 14 | 45 | ? | Да | 14 | ? | ? | 50 | ? | 15 | ? |
Примеры
При нажатии пользователем на значок действия на странице, скрыть его и перейти к активной вкладке по адресу "https://giphy.com/explore/cat":
let CATGIFS = "https://giphy.com/explore/cat"; browser.pageAction.onClicked.addListener((tab) => { browser.pageAction.hide(tab.id); browser.tabs.update({url: CATGIFS}); }); browser.pageAction.onClicked.addListener(() => { });
Примеры расширений
Примечание:
Этот API основан на API chrome.pageAction Chromium. Данная документация взята из page_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/pageAction/onClicked