Spec-Zone.ru › Web Extensions

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.

button

Число. Указывает кнопку, используемую для нажатия значка действия на странице: 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(() => {
});

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

  • apply-css
  • chill-out

Примечание:

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

Spec-Zone.ru

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