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"
}

浏览器兼容性