覆寫 Chrome 網頁

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

書籤管理員
使用者選擇「書籤管理員」選單項目後顯示的頁面 開啟 Chrome 選單;在 Mac 上,則是選取 [書籤] 選單中的「書籤管理員」項目。你也可以 輸入網址 chrome://bookmarks,即可前往這個頁面。
記錄
使用者從 Chrome 選擇「歷史記錄」選單項目時所顯示的頁面 功能表,或在 Mac 上按一下 [記錄] 選單中的 [顯示完整記錄] 項目。你也可以前往這個頁面 輸入網址 chrome://history
新分頁
使用者開啟新分頁或視窗時顯示的頁面。你也可以前往 輸入網址 chrome://newtab

下列螢幕截圖顯示預設的「新分頁」頁面和自訂的新分頁。

預設新分頁
預設的新分頁
,瞭解如何調查及移除這項存取權。
自訂新分頁
自訂新分頁

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

無痕視窗行為

在無痕視窗中,擴充功能無法覆寫新分頁。如果無痕模式資訊清單屬性: 設為「spanning」(預設值)。如要進一步瞭解如何處理無痕式視窗,請參閱「儲存資料與無痕模式」。

資訊清單

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

{
  "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 預設新分頁混淆的新分頁。

範例

請參閱覆寫範例一文。