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