menus.OnClickData
当点击菜单项时,传递给 menus.onClicked
事件侦听器的信息。
类型
此类型的值是对象。它们包含以下属性:
bookmarkId
可选-
string
。点击上下文菜单时书签的 ID。 -
integer
。按下的鼠标按钮。值与MouseEvent.button
相同。 checked
可选-
boolean
。一个标志,指示复选框或单选按钮项在被点击后是否被选中。 editable
-
boolean
。一个标志,指示元素是否可编辑:例如,如果它是一个textarea
。 frameId
可选-
integer
。点击项所在的 frame 的 ID。frame ID 可用于接受 frame ID 的其他 API,例如tabs.sendMessage()
。如果项是在顶层文档中被点击的,则frameId
为零。如果项是在页面外部被点击的(例如,在tools_menu
或tab
上下文中),则frameId
为undefined
。 frameUrl
可选-
string
。如果上下文菜单是在 frame 中的元素上激活的,则为该 frame 的 URL。 linkText
可选-
string
。如果元素是链接,则为链接的文本。如果链接不包含文本,则此处提供链接本身。 linkUrl
可选-
string
。如果元素是链接,则为它指向的 URL。 mediaType
可选-
string
。如果上下文菜单是在这些类型的元素上激活的,则为 "image"、"video" 或 "audio" 之一。 -
integer
或string
。被点击的菜单项的 ID。 modifiers
-
array
ofstring
。一个包含点击项时按下的任何修饰键的数组。可能的值包括:"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
。一个标志,指示复选框或单选按钮项在被点击之前是否被选中。
浏览器兼容性
加载中…
注意:此 API 基于 Chromium 的 chrome.contextMenus
API。本文档来源于 Chromium 代码中的 context_menus.json
。