工具栏按钮
通常称为 浏览器操作,此用户界面选项是添加到浏览器工具栏的按钮。用户点击该按钮与您的扩展进行交互。
工具栏按钮(浏览器操作)与地址栏按钮(页面操作)非常相似。有关差异以及何时使用什么内容的指南,请参阅 页面操作和浏览器操作。
指定浏览器操作
您可以使用 "browser_action"
键在 manifest.json 中定义浏览器操作的属性
json
"browser_action": {
"default_icon": {
"19": "button/geo-19.png",
"38": "button/geo-38.png"
},
"default_title": "Whereami?"
}
此键没有强制属性。如果您未指定 "default_icon"
,则使用扩展图标,如果扩展未指定图标,则使用默认的 Web 扩展拼图块图标。如果未指定 "default_title"
,则使用扩展名称。
有两种方法可以指定浏览器操作:使用或不使用 弹出窗口。如果您未指定弹出窗口,则当用户点击按钮时,会向扩展分派一个事件,扩展使用 browserAction.onClicked
侦听该事件
js
browser.browserAction.onClicked.addListener(handleClick);
如果您指定了弹出窗口,则不会分派点击事件:而是当用户点击按钮时显示弹出窗口。用户可以与弹出窗口交互,当用户点击弹出窗口外部时,弹出窗口会自动关闭。有关创建和管理弹出窗口的更多详细信息,请参阅 弹出窗口 文章。
请注意,您的扩展只能有一个浏览器操作。
您可以使用 browserAction
API 以编程方式更改许多浏览器操作属性。
图标
有关如何创建与浏览器操作一起使用的图标的详细信息,请参阅 图标 在 Acorn 设计系统 文档中。
示例
GitHub 上的 webextensions-examples
存储库包含两个实现浏览器操作的扩展示例
- bookmark-it 使用不带弹出窗口的浏览器操作
- beastify 使用带弹出窗口的浏览器操作