pageAction.onClicked

當頁面操作圖示被點選時觸發。如果頁面操作帶有彈出視窗,此事件將不會觸發。

要定義右鍵單擊操作,請使用帶有“page_action”上下文型別contextMenus API。

語法

js
browser.pageAction.onClicked.addListener(listener)
browser.pageAction.onClicked.removeListener(listener)
browser.pageAction.onClicked.hasListener(listener)

事件有三個函式

addListener(listener)

向此事件新增監聽器。

removeListener(listener)

停止監聽此事件。listener 引數是要移除的監聽器。

hasListener(listener)

檢查此事件是否已註冊 listener。如果正在偵聽,則返回 true,否則返回 false

addListener 語法

引數

監聽器

此事件發生時呼叫的函式。該函式會傳遞以下引數:

tab

一個代表頁面操作被點選的選項卡 的tabs.Tab 物件。

OnClickData

包含有關單擊事件資訊的物件。

modifiers

一個陣列。單擊時處於啟用狀態的鍵盤修飾鍵,可以是一個或多個:ShiftAltCommandCtrlMacCtrl

button

一個整數。指示用於單擊頁面操作圖示的按鈕:0 表示左鍵單擊或與滑鼠無關的單擊(例如來自鍵盤的單擊),1 表示中鍵或滾輪單擊。請注意,不支援右鍵單擊,因為 Firefox 在觸發此事件之前會消耗該單擊以顯示上下文選單。

示例

當用戶點選頁面操作時,隱藏它,並將活動選項卡導航到“https://giphy.com/explore/cat

js
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 基於 Chromium 的 chrome.pageAction API。本文件源自 Chromium 程式碼中的 page_action.json