Spec-Zone.ru › Web Extensions

menus.OnClickData

Информация, передаваемая слушателю события menus.onClicked при нажатии на элемент меню.

Тип

Значения этого типа — объекты. Они содержат следующие свойства:

bookmarkId Необязательно

string. Идентификатор закладки, где был нажат контекстное меню.

button Необязательно

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", если контекстное меню было активировано на одном из этих типов элементов.

menuItemId

integer или string. Идентификатор нажатого элемента меню.

modifiers

array string. Массив, содержащий нажатые клавиши модификаторов при нажатии элемента. Возможные значения: "Alt", "Command", "Ctrl", "MacCtrl" и "Shift". На Mac, если нажата клавиша Control, то включаются оба значения "Ctrl" и "MacCtrl".

pageUrl Необязательно

string. URL страницы, на которой был нажат элемент меню. Это свойство отсутствует, если нажатие произошло в контексте, где нет текущей страницы, например, на действии браузера.

parentMenuItemId Необязательно

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 нажатого элемента.
48
? Да 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API