实现操作

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

注册操作

如需使用 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”示例会显示带有“ON”的徽章，以向用户表明他们已成功设置闹钟；当扩展程序处于空闲状态时，则不显示任何内容。徽章最多可以包含四个字符。

如需设置徽章的文本，请调用 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() 来设置或更新提示。如果未设置提示，则会显示扩展程序的名称。