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-
一個
陣列。單擊時處於啟用狀態的鍵盤修飾鍵,可以是一個或多個:Shift、Alt、Command、Ctrl或MacCtrl。 -
一個
整數。指示用於單擊頁面操作圖示的按鈕: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。