chrome_url_overrides

型別 Object
必填
Manifest 版本 2 或更高
示例
json
  "chrome_url_overrides" : {
    "newtab": "my-new-tab.html"
  }

使用 chrome_url_overrides 鍵來提供對通常由瀏覽器自身提供的各種特殊頁面中載入的文件的自定義替換。

語法

chrome_url_overrides 鍵是一個物件,可能包含以下屬性:

名稱 型別 描述
bookmarks String

提供一個替換項,用於顯示書籤的頁面。

history String

提供一個替換項,用於顯示瀏覽歷史記錄的頁面。

newtab String

提供一個替換項,用於顯示“新標籤頁”的文件。這是使用者開啟新標籤頁但未載入任何文件時顯示的頁面:例如,透過使用 Ctrl/Command+T 鍵盤快捷鍵。

替換項以 HTML 檔案 URL 的形式提供。該檔案必須隨擴充套件程式一起打包:您不能在此指定遠端 URL。您可以將其相對於擴充套件程式的根資料夾指定,例如:“path/to/newtab.html”。

該文件可以像普通的網頁一樣載入 CSS 和 JavaScript。頁面中執行的 JavaScript 可以訪問與擴充套件程式的後臺指令碼相同的 特權的“browser.*”API

為頁面包含 <title> 是一個很好的做法,否則選項卡的標題將是“moz-extension://...”URL。

一種常見的用例是允許使用者定義一個新的標籤頁:為此,請提供一個自定義的新標籤頁,該新標籤頁會導航到使用者定義的頁面。

如果兩個或多個擴充套件都定義了自定義新標籤頁,則最後安裝或啟用的擴充套件將使用其值。

要覆蓋瀏覽器的首頁,請改用“chrome_settings_overrides”。

所有屬性都 支援本地化

示例

json
"chrome_url_overrides" : {
  "newtab": "my-new-tab.html"
}

瀏覽器相容性