pageAction

讀取和修改透過 page_action manifest 鍵定義的位址列按鈕的屬性,並監聽其點選事件。

位址列按鈕是新增到瀏覽器位址列的一個按鈕。

Paw print icon representing a page action

你可以在後臺指令碼中監聽圖示點選事件,或者指定一個在圖示被點選時開啟的 彈出視窗

如果你指定了一個彈出視窗,你可以使用 HTML、CSS 和 JavaScript 來定義它的內容和行為。在彈出視窗中執行的 JavaScript 可以訪問與你的後臺指令碼相同的 WebExtension API。儘管被命名為 pageAction,但操作程式碼無法訪問網頁內容。要訪問網頁 DOM,你需要新增一個 內容指令碼 並與之互動。

該按鈕還有一個上下文選單,你可以使用 page_action menus.ContextType 透過 menus API 向此選單新增專案。

頁面操作(Page actions)用於僅對特定頁面相關的操作(例如“收藏當前標籤頁”)。如果它們與整個瀏覽器相關(例如“顯示所有收藏夾”),則應改用 瀏覽器操作(browser action)

型別

pageAction.ImageDataType

影像的畫素資料。

函式

pageAction.show()

顯示指定標籤頁的頁面操作。

pageAction.hide()

隱藏指定標籤頁的頁面操作。

pageAction.isShown()

檢查頁面操作是否顯示。

pageAction.setTitle()

設定頁面操作的標題。這將在頁面操作上方的工具提示中顯示。

pageAction.getTitle()

獲取頁面操作的標題。

pageAction.setIcon()

設定頁面操作的圖示。

pageAction.setPopup()

設定頁面操作彈出視窗的 URL。

pageAction.getPopup()

獲取頁面操作彈出視窗的 URL。

pageAction.openPopup()

開啟頁面操作的彈出視窗。

事件

pageAction.onClicked

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

擴充套件程式示例

瀏覽器相容性

注意: 此 API 基於 Chromium 的 chrome.pageAction API。本文件源自 Chromium 程式碼中的 page_action.json