覆寫 Chrome 網頁

擴充功能可以使用 HTML 覆寫頁面,取代 Google Chrome 通常提供的頁面。擴充功能可包含下列任一網頁的覆寫值,但每個擴充功能只能覆寫一個網頁:

書籤管理員
使用者從 Chrome 選單中選擇「書籤管理員」選單項目,或在 Mac 上從「書籤」選單中選擇「書籤管理員」項目時顯示的頁面。您也可以輸入網址 chrome://bookmarks 前往這個頁面。
記錄
當使用者從 Chrome 選單中選擇「歷史記錄」選單項目,或在 Mac 上從「歷史記錄」選單中選擇「顯示完整歷史記錄」項目時,系統會顯示的頁面。您也可以輸入網址 chrome://history 前往這個頁面。
新分頁
使用者建立新分頁或視窗時顯示的頁面。您也可以輸入網址 chrome://newtab 前往這個頁面。

下列螢幕截圖顯示預設的新分頁頁面,以及自訂的新分頁頁面。

預設的新分頁
預設新分頁頁面。
自訂新分頁
自訂新分頁頁面。

如要試用這項功能,請參閱覆寫範例

無痕視窗行為

在無痕式視窗中,擴充功能無法覆寫新分頁頁面。如果「無痕模式」資訊清單屬性設為「跨越」(預設值),其他網頁仍可正常運作。如要進一步瞭解如何處理無痕式視窗,請參閱「儲存資料和無痕模式」。

資訊清單

請使用以下程式碼,在擴充功能資訊清單中註冊覆寫頁面:

{
  "manifest_version": 3,
  "name": "My extension",
  ...

  "chrome_url_overrides" : {
    "PAGE_TO_OVERRIDE": "myPage.html"
  },
  ...
}

請將 PAGE_TO_OVERRIDE 替換為下列其中一個值:

  • "bookmarks"
  • "history"
  • "newtab"

最佳做法

  • 讓網頁快速又小巧。
    使用者希望內建瀏覽器網頁能立即開啟。避免執行可能需要很長時間的作業。具體來說,請避免以同步方式存取資料庫資源。發出網路要求時,請優先使用 fetch(),而非 XMLHttpRequest()

  • 為避免使用者混淆,請為網頁加上標題。
    如果沒有標題,系統會將網頁標題預設為網址。在 HTML 檔案中使用 <title> 標記指定標題。

  • 請注意,新分頁會先將鍵盤焦點放在網址列上。
    請勿依賴鍵盤焦點預設為網頁其他部分。

  • 打造專屬的新分頁
    避免建立使用者可能會與 Chrome 預設新分頁混淆的新分頁。

範例

請參閱覆寫範例