chrome extension - browser action

broser action 可以把扩展的图标放置在地址栏的右侧，除了图标还可以有 tooltip、badge 和 popup。

01.png

manifest

---

在manifest.json中注册 browser action。

{
    ...
    "browser_action": {
        "default_icon": {                    // optional
            "16": "images/icon16.png",       // optional
            "24": "images/icon24.png",       // optional
            "32": "images/icon32.png"        // optional
        },
        "default_title": "foo",              // optional; shown in tooltip
        "default_popup": "popup.html"        // optional
    },
    ...
}

icon

---

chrome 中 browser action 的 icons 都是 16 dips（device-independent pixels）。大的图标会自动调整大小。

可以通过两种方式设置图标：

• 静态的图片。可以是任何 webkit 可以显示的格式（BMP、GIF、ICO、JPEG & PNG）。没有打包的扩展，图片必须是 png 格式。
• HTML5 canvas element

设置图标的方法：

• manifest
• browserAction.setIcon

tooltip

---

设置提示的方法：

• manifest
• browserAction.setTitle

当然提示的信息也可以本地化。

badge

---

browser action 可以额外的显示一个徽章。徽章是有限制大小的，所以最好是4个字符以下。

browserAction.setBadgeText设置徽章的文本。
browserAction.setBadgeBackgroundColor设置徽章的颜色。

popup

---

当用户单击图标时，popup 会出现。

添加 popup 的方法：

• manifest
• browserAction.setPopup

see also browser action