该页面翻译自 Google Chrome Extensions 与 Google Chrome Apps。除非特别说明,该页面的内容遵循 Creative Commons Attribution 3.0 License,代码示例遵循 BSD License。
替代页面是一种使用来自您的扩展程序的 HTML 文件替换 Google Chrome 默认提供页面的方式。除了 HTML,替代页面通常还包含 CSS 和 JavaScript 代码。
扩展程序可以替换以下任一页面:
注意:一个扩展程序只能替换一个页面。例如,一个扩展程序不能既替换书签管理页面,又替换历史记录页面。
隐身窗口是特殊对待的,“打开新的标签页”页面不能在隐身窗口中替换。只要清单文件中的 incognito 属性设置为 "spanning"(也是默认值),其他替代页面将在隐身窗口中工作。有关您应该如何对待隐身窗口的更多细节,请参见概述中的保存数据和隐身模式。
以下屏幕截图展现了缺省的“打开新的标签页”页面和自定义的“打开新的标签页”页面。
缺省的“打开新的标签页”页面 | 替代的“打开新的标签页”页面 |
如下所示在扩展程序的清单文件中注册替代页面:
{ "name": "我的扩展程序", ... "chrome_url_overrides" : { "pageToOverride": "myPage.html" }, ... }
将 pageToOverride
替换为以下值之一:
bookmarks
history
newtab
要想创建一个高效的替代页面,请遵循这些指导:
使您的页面又快又小。
用户期望内置的浏览器页面能够立即打开。请避免做任何可能花较长时间的事情,例如,避免同步地获取网络或数据库资源。
在您的页面中包含标题。
否则用户可能会看到页面的
URL,会令人感到疑惑。这是一个指定标题的例子:<title>新标签页</title>
不要假定页面具有键盘焦点。
当用户创建新标签页时总是地址栏先获得焦点。
不要试着模仿默认的“打开新的标签页”页面。
用于创建与默认的“打开新的标签页”页面类似(具有最常访问的网站、最近关闭的标签页、提示、主题背景图像等等)的修改版本所需的
API 还不存在。在出现那些 API
之前您还是最好还是考虑一些完全不同的新想法。
请参见替代页面示例。