menus.OnClickData
Информация, передаваемая слушателю события menus.onClicked при нажатии на элемент меню.
Тип
Значения этого типа — объекты. Они содержат следующие свойства:
-
bookmarkIdНеобязательно -
string. Идентификатор закладки, где был нажат контекстное меню. -
integer. Которая кнопка мыши была нажата. Значения совпадают со значениями дляMouseEvent.button. -
checkedНеобязательно -
boolean. Флаг, указывающий, был ли галочный или радиоэлемент отмечен после нажатия. editable-
boolean. Флаг, указывающий, является ли элемент редактируемым: например, если это textarea. -
frameIdНеобязательно -
integer. Идентификатор фрейма, в котором был нажат элемент. Идентификатор фрейма может быть использован в других 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. Идентификатор нажатого элемента меню. modifiers-
arraystring. Массив, содержащий нажатые клавиши модификаторов при нажатии элемента. Возможные значения: "Alt", "Command", "Ctrl", "MacCtrl" и "Shift". На Mac, если нажата клавиша Control, то включаются оба значения "Ctrl" и "MacCtrl". -
pageUrlНеобязательно -
string. URL страницы, на которой был нажат элемент меню. Это свойство отсутствует, если нажатие произошло в контексте, где нет текущей страницы, например, на действии браузера. -
integerилиstring. Идентификатор родительского элемента, если он есть. -
selectionTextНеобязательно -
string. Если на странице был выбран текст, здесь содержится выбранный текст. -
srcUrlНеобязательно -
string. Если присутствует, значениеsrcдля медиафайла в нажатом элементе. -
targetElementIdНеобязательно -
integer. Идентификатор элемента, над которым было создано контекстное меню. Используйтеmenus.getTargetElement()в скрипте содержимого для поиска элемента. Обратите внимание, что это не атрибут id элемента на странице. -
viewTypeНеобязательно -
ViewType. Тип расширения. -
wasCheckedНеобязательно -
boolean. Флаг, указывающий, был ли галочный или радиоэлемент отмечен до нажатия.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
OnClickData |
Да | Да | 5548 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
bookmarkId |
Нет | Нет | 59 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
button |
Нет | Нет | 64 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
frameId |
35 | 79 | 55 | ? | 22 | 14 | ? | ? | Нет | ? | Нет | ? |
linkText |
Нет | Нет | 56 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
modifiers |
Нет | Нет | 54 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
srcUrl |
Да | Да |
59–94Возвращает URL после перенаправления, а не значение атрибутаsrc нажатого элемента. |
? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
targetElementId |
Нет | Нет | 63 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
Примечание: Этот API основан на API chrome.contextMenus Chromium. Данная документация взята из context_menus.json кода Chromium.
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/menus/OnClickData