menus.ContextType
菜单项可以出现的不同上下文。
类型
此类型的值是字符串。当给定上下文适用时,会显示该菜单项。可能的值为:
- all
-
'all' 的指定等同于除 'bookmark'、'tab' 和 'tools_menu' 之外的所有其他上下文的组合。
- action
-
当用户在 Manifest V3 扩展中右键单击你的浏览器操作时应用。添加到顶层浏览器操作上下文菜单的最多项数为
menus.ACTION_MENU_TOP_LEVEL_LIMIT,但你可以向子菜单添加任意数量的项。 - audio
-
当用户右键单击 audio 元素时应用。
- bookmark
-
当用户右键单击书签工具栏、书签菜单、书签侧边栏(Ctrl+B)和库窗口(Ctrl+Shift+B)中的书签项时应用。后者(库窗口和侧边栏)从 Firefox 66 开始支持。需要在 manifest 中具有 "bookmarks" API 权限。
- browser_action
-
当用户在 Manifest V2 扩展中右键单击你的浏览器操作时应用。添加到顶层浏览器操作上下文菜单的最多项数为
menus.ACTION_MENU_TOP_LEVEL_LIMIT,但你可以向子菜单添加任意数量的项。 - editable
-
当用户右键单击可编辑元素(如 textarea)时应用。
- frame
-
当用户在嵌套的 iframe 中右键单击时应用。
- 图片
-
当用户右键单击图片时应用。
- link
-
当用户右键单击链接时应用。
- page
-
当用户在页面中右键单击,但其他页面上下文均不适用时(例如,点击的不是图片、嵌套 iframe 或链接)应用。
- page_action
-
当用户右键单击你的页面操作时应用。添加到顶层页面操作上下文菜单的最多项数为
menus.ACTION_MENU_TOP_LEVEL_LIMIT,但你可以向子菜单添加任意数量的项。 - 密码
-
当用户右键单击 password input 元素 时应用。
- selection
-
当页面部分内容被选中时应用。
- tab
-
当用户右键单击标签页时应用(具体来说,这是指用于让用户在不同浏览器标签页之间切换的标签页条或其他用户界面元素,而不是页面本身)。
从 Firefox 63 开始,即使点击的标签页不是当前活动标签页,在标签页上点击菜单项也会授予该标签页 activeTab 权限。
-
该项将添加到浏览器的工具菜单中。请注意,仅当你通过
menus命名空间访问ContextType时才可用。如果你通过contextMenus命名空间访问,则不可用。 - video
-
当用户右键单击 video 元素时应用。
请注意,“launcher” 不受支持。
浏览器兼容性
加载中…
注意: 此 API 基于 Chromium 的 chrome.contextMenus API。本文档源自 Chromium 代码中的 context_menus.json。