menus.OnClickData
传递给 menus.onClicked
事件监听器的信息,当菜单项被点击时。
类型
此类型的值为对象。它们包含以下属性
bookmarkId
可选-
string
。上下文菜单被点击的书签的 ID。 -
integer
。按下哪个鼠标按钮。值与MouseEvent.button
的值相同。 checked
可选-
boolean
。一个标志,指示复选框或单选按钮在被点击后是否被选中。 可编辑
-
boolean
。一个标志,指示元素是否可编辑:例如,如果它是一个 textarea。 frameId
可选-
integer
。点击该项目的框架的 ID。框架 ID 可用于其他接受框架 ID 的 API,例如tabs.sendMessage()
。如果该项目在顶级文档中被点击,则frameId
为零。如果该项目完全在页面外部被点击(例如,在tools_menu
或tab
上下文中),则frameId
为undefined
。 frameUrl
可选-
string
。如果上下文菜单在框架中被点击,则为该元素所在的框架的 URL。 linkText
可选-
string
。如果元素是链接,则为链接的文本。如果链接不包含文本,则此处给出 URL 本身。 linkUrl
可选-
string
。如果元素是链接,则为其指向的 URL。 mediaType
可选-
string
。如果上下文菜单在以下类型的元素之一上激活,则为 "image"、"video" 或 "audio" 之一。 -
integer
或string
。被点击的菜单项的 ID。 modifiers
-
string
的array
。一个包含点击该项目时按下的任何修饰键的数组。可能的值包括:"Alt"、"Command"、"Ctrl"、"MacCtrl" 和 "Shift"。在 Mac 上,如果用户按下了 Control 键,则 "Ctrl" 和 "MacCtrl" 都包含在内。 pageUrl
可选-
string
。点击菜单项的页面的 URL。如果点击发生在没有当前页面的上下文中(例如,在浏览器操作上),则此属性不存在。 -
integer
或string
。如果存在,则为被点击项目的父 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
。