menus.OnClickData

当点击菜单项时,传递给 menus.onClicked 事件侦听器的信息。

类型

此类型的值是对象。它们包含以下属性:

bookmarkId 可选

string。点击上下文菜单时书签的 ID。

button 可选

integer。按下的鼠标按钮。值与 MouseEvent.button 相同。

checked 可选

boolean。一个标志,指示复选框或单选按钮项在被点击后是否被选中。

editable

boolean。一个标志,指示元素是否可编辑:例如,如果它是一个 textarea

frameId 可选

integer。点击项所在的 frame 的 ID。frame ID 可用于接受 frame ID 的其他 API,例如 tabs.sendMessage()。如果项是在顶层文档中被点击的,则 frameId 为零。如果项是在页面外部被点击的(例如,在 tools_menutab 上下文中),则 frameIdundefined

frameUrl 可选

string。如果上下文菜单是在 frame 中的元素上激活的,则为该 frame 的 URL。

linkText 可选

string。如果元素是链接,则为链接的文本。如果链接不包含文本,则此处提供链接本身。

linkUrl 可选

string。如果元素是链接,则为它指向的 URL。

mediaType 可选

string。如果上下文菜单是在这些类型的元素上激活的,则为 "image"、"video" 或 "audio" 之一。

integerstring。被点击的菜单项的 ID。

modifiers

array of string。一个包含点击项时按下的任何修饰键的数组。可能的值包括:"Alt"、"Command"、"Ctrl"、"MacCtrl" 和 "Shift"。在 Mac 上,如果用户按下了 Control 键,则同时包含 "Ctrl" 和 "MacCtrl"。

pageUrl 可选

string。点击菜单项所在的页面的 URL。如果点击发生在没有当前页面的上下文中,例如在浏览器操作上,则此属性不存在。

parentMenuItemId 可选

integerstring。被点击项的父 ID(如果存在)。

selectionText 可选

string。如果页面上选择了文本,则包含所选文本。

srcUrl 可选

string。如果存在,则为被点击元素中媒体的 src 值。

targetElementId 可选

integer。上下文菜单创建所在元素的标识符(如果存在)。使用内容脚本中的 menus.getTargetElement() 来定位元素。请注意,这并非页面元素的 id 属性。

viewType 可选

ViewType。扩展视图的类型。

wasChecked 可选

boolean。一个标志,指示复选框或单选按钮项在被点击之前是否被选中。

浏览器兼容性

注意:此 API 基于 Chromium 的 chrome.contextMenus API。本文档来源于 Chromium 代码中的 context_menus.json