menus.ContextType
菜单项可以显示的不同上下文。
类型
此类型的值为字符串。当给定上下文适用时,将显示该项。可能的值为
- 全部
-
指定“全部”等效于除“书签”、“标签页”和“工具菜单”之外的所有其他上下文的组合。
- 操作
-
当用户在 Manifest V3 扩展中右键单击您的浏览器操作时适用。可以添加到顶级浏览器操作上下文菜单的项目最大数量为
menus.ACTION_MENU_TOP_LEVEL_LIMIT
,但您可以向子菜单添加任意数量的项目。 - 音频
-
当用户右键单击 音频 元素时适用。
- 书签
-
当用户右键单击书签工具栏、书签菜单、书签侧边栏(Ctrl+B)和库窗口(Ctrl+Shift+B)中的书签项时适用。后者两个从 Firefox 66 开始受支持。需要清单中的“书签” API 权限。
- 浏览器操作
-
当用户在 Manifest V2 扩展中右键单击您的浏览器操作时适用。可以添加到顶级浏览器操作上下文菜单的项目最大数量为
menus.ACTION_MENU_TOP_LEVEL_LIMIT
,但您可以向子菜单添加任意数量的项目。 - 可编辑
-
当用户右键单击可编辑元素(如 textarea)时适用。
- 框架
-
当用户右键单击嵌套的 iframe 中时适用。
- 图像
-
当用户右键单击图像时适用。
- 链接
-
当用户右键单击链接时适用。
- 页面
-
当用户右键单击页面中,但其他页面上下文都不适用时适用(例如,点击不在图像、嵌套 iframe 或链接上)。
- 页面操作
-
当用户右键单击您的页面操作时适用。可以添加到顶级页面操作上下文菜单的项目最大数量为
menus.ACTION_MENU_TOP_LEVEL_LIMIT
,但您可以向子菜单添加任意数量的项目。 - 密码
-
当用户右键单击 密码输入元素 时适用。
- 选择
-
当页面的一部分被选中时适用。
- 标签页
-
当用户右键单击标签页时适用(具体来说,这指的是标签栏或其他允许用户从一个浏览器标签切换到另一个浏览器标签的用户界面元素,而不是页面本身)。
从 Firefox 63 开始,在标签页上单击菜单项将授予该标签页的 activeTab 权限,即使该标签页不是当前活动标签页。
-
该项目将添加到浏览器的工具菜单中。请注意,这仅在您通过
menus
命名空间访问ContextType
时可用。如果您通过contextMenus
命名空间访问它,则不可用。 - 视频
-
当用户右键单击 视频 元素时适用。
请注意,“启动器”不受支持。
浏览器兼容性
BCD 表仅在浏览器中加载
注意:此 API 基于 Chromium 的 chrome.contextMenus
API。本文档源自 Chromium 代码中的 context_menus.json
。