如果想在 Google Chrome 平時提供的網頁中,替換擴充功能中的 HTML 檔案,可以使用覆寫網頁的方式。除了 HTML 以外,覆寫網頁通常也有 CSS 和 JavaScript 程式碼。
擴充功能可以取代以下網頁其中之一:
- 書籤管理員:使用者從 Chrome 選單選擇「書籤管理員」選單項目,或從 Mac 的「書籤管理員」選單選擇「書籤管理員」項目時,顯示的網頁。您也可以輸入 chrome://書籤 s 來前往這個網頁。
- 歷史記錄:使用者從 Chrome 選單選擇「歷史記錄」選單項目時會顯示的頁面,Mac 使用者從「歷史記錄」選單選擇「顯示完整歷史記錄」項目。您也可以輸入 chrome://history 網址前往這個頁面。
- 新分頁:使用者建立新分頁或視窗時顯示的網頁。您也可以輸入 chrome://newtab 網址前往這個頁面。
注意:單一擴充功能只能覆寫一個網頁。舉例來說,擴充功能無法同時覆寫「書籤管理員」和「歷史記錄」頁面。
系統會特別處理無痕式視窗。無法在無痕式視窗中覆寫新分頁。 只要無痕模式資訊清單屬性設為「跨距」(預設值),其他覆寫頁面即可在無痕式視窗中正常運作。請參閱總覽的「儲存資料和無痕模式」一節,進一步瞭解如何處理無痕式視窗。
以下螢幕截圖顯示預設的「新分頁」和自訂「新分頁」頁面。
資訊清單
在擴充功能資訊清單中註冊覆寫頁面,如下所示:
{
"name": "My extension",
...
"chrome_url_overrides" : {
"PAGE_TO_OVERRIDE": "myPage.html"
},
...
}
如果是 PAGE_TO_OVERRIDE
,則可替換為下列任一值:
bookmarks
history
newtab
提示
如要建立有效的覆寫頁面,請遵守下列規範:
- 打造簡短的網頁。 使用者會希望內建瀏覽器網頁會立即開啟。避免執行可能需要較長時間的操作。舉例來說,請避免同步擷取網路或資料庫資源。
- 在網頁中加入標題。
否則使用者可能會看到網頁的網址,造成混淆。以下為指定標題的範例:
<title>New Tab</title>
- 請勿依賴鍵盤焦點。 使用者建立新分頁時,網址列的焦點一律會優先顯示。
- 請勿嘗試模擬預設的「新分頁」頁面。 如要建立稍微修改的預設「新分頁」頁面 (包括頂端頁面、近期關閉頁面、提示、主題背景圖片等) 所需的 API,目前尚不存在。在他們這麼做之前,您最好先設法進行完全不同的內容。
範例
請參閱「覆寫範例」。