pageAction
讀取和修改透過 page_action manifest 鍵定義的位址列按鈕的屬性,並監聽其點選事件。
位址列按鈕是新增到瀏覽器位址列的一個按鈕。

你可以在後臺指令碼中監聽圖示點選事件,或者指定一個在圖示被點選時開啟的 彈出視窗。
如果你指定了一個彈出視窗,你可以使用 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。