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-
arrayofstring。一个包含点击项时按下的任何修饰键的数组。可能的值包括:"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。