menus.OnClickData

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

类型

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

bookmarkId 可选

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

button 可选

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

checked 可选

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

可编辑

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

frameId 可选

integer。点击该项目的框架的 ID。框架 ID 可用于其他接受框架 ID 的 API,例如 tabs.sendMessage()。如果该项目在顶级文档中被点击,则 frameId 为零。如果该项目完全在页面外部被点击(例如,在 tools_menutab 上下文中),则 frameIdundefined

frameUrl 可选

string。如果上下文菜单在框架中被点击,则为该元素所在的框架的 URL。

linkText 可选

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

linkUrl 可选

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

mediaType 可选

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

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

modifiers

stringarray。一个包含点击该项目时按下的任何修饰键的数组。可能的值包括:"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。一个标志,指示复选框或单选按钮在被点击前是否被选中。

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

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