上下文菜单项

此用户界面选项将一个或多个项添加到浏览器上下文菜单。这是用户在网页上右键单击时出现的菜单。选项卡和书签也可以有上下文菜单，可以通过 menus API 使用。

您可以使用此选项公开与特定浏览器或网页上下文相关的功能。例如，当用户单击图像时，您可以显示打开图形编辑器的功能，或者在选择页面的一部分时，您可以提供保存页面内容的功能。您可以向菜单添加普通菜单项、复选框项、单选按钮组和分隔符。使用 menus.create 添加上下文菜单项后，它将显示在所有浏览器选项卡中，但您可以通过使用 menus.remove 删除它来隐藏它。

支持的全部上下文列表可在 menus.ContextType 中找到，其中包括网页之外的上下文，例如浏览器 UI 中的书签项。例如，"在容器选项卡中打开书签" 扩展添加了一个菜单项，允许用户在新容器选项卡中打开书签 URL。

您还可以使用 menus.overrideContext 覆盖扩展页面（例如自定义侧边栏和弹出窗口）中显示的上下文菜单，以使用选项卡或书签上下文菜单代替默认上下文菜单。当您的扩展提供选项卡或书签的自定义显示时，这是一个有用的方法。该菜单会自动包含任何其他已定义选项卡或书签上下文菜单项的扩展的菜单项。您可以选择是否包含默认上下文菜单项。隐藏默认项使扩展完全控制在呈现的本机上下文菜单中显示的项，如下图所示，显示了 Tree Style Tab 扩展。

"permissions": ["contextMenus"]

browser.contextMenus.create(
  {
    id: "log-selection",
    title: browser.i18n.getMessage("contextMenuItemSelectionLogger"),
    contexts: ["selection"],
  },
  onCreated,
);

browser.contextMenus.onClicked.addListener((info, tab) => {
  switch (info.menuItemId) {
    case "log-selection":
      console.log(info.selectionText);
      break;
    // …
  }
});