实现操作

操作是指用户点击工具栏图标（通常称为扩展程序的操作图标）后会发生的情况。操作会使用 Action API 调用扩展程序功能，或者打开弹出式窗口。本页介绍了如何调用扩展程序功能。如需使用弹出式窗口，请参阅添加弹出式窗口。

注册操作

如需使用 chrome.action API，请将 "action" 键添加到该扩展程序的清单文件中。有关此字段的可选属性的完整说明，请参阅 chrome.action API 参考文档的清单部分。

manifest.json:

{
  "name": "My Awesome action Extension",
 ...
  "action": {
   ...
  }
 ...
}

响应操作

注册在用户点击操作图标时运行的 onClicked 处理程序。如果在 manifest.json 文件中注册了弹出式窗口，则不会触发此事件。

service-worker.js：

chrome.action.onClicked.addListener((tab) => {
  chrome.action.setTitle({
    tabId: tab.id,
    title: `You are on tab: ${tab.id}`});
});

有条件地激活操作

借助 chrome.declarativeContent API，您可以根据网页网址或在 CSS 选择器与网页上的元素匹配时启用扩展程序的操作图标。如果停用某个扩展程序的操作图标，该图标会灰显。如果用户点击“已停用”图标，系统会显示该扩展程序的上下文菜单。

已停用的操作图标。

操作徽章

标记是放置在操作图标上方的一小段带有格式的文本，用于指示扩展程序状态或用户需要执行的操作等。为了演示这一点，Drink Water 示例会显示一个带有“开启”的标志，向用户显示已成功设置闹钟，而当扩展程序处于闲置状态时，系统不会显示任何内容。标记最多可包含 4 个字符。

不带标志的扩展程序图标（左）和带标志的扩展程序图标（右）。

通过调用 chrome.action.setBadgeText() 设置标志的文本，并通过调用 chrome.action.setBadgeBackgroundColor()` 设置背景颜色。

service-worker.js：

chrome.action.setBadgeText({text: 'ON'});
chrome.action.setBadgeBackgroundColor({color: '#4688F1'});

提示

在 manifest.json 文件中的 "action" 键下的 "default_title" 字段中注册提示。

manifest.json:

{
  "name": "Tab Flipper",
 ...
  "action": {
    "default_title": "Press Ctrl(Win)/Command(Mac)+Shift+Right/Left to flip tabs"
  }
...
}

您还可以通过调用 action.setTitle()` 设置或更新提示。如果未设置提示，系统会显示扩展程序的名称。