menus.ContextType
Разные контексты, в которых может отображаться элемент меню.
Тип
Значения этого типа — строки. Элемент отображается, когда указанный контекст применим. Возможные значения:
- all
-
Указание «all» эквивалентно комбинации всех других контекстов, кроме «bookmark», «tab» и «tools_menu».
- action
-
Применяется, когда пользователь щелкает правой кнопкой мыши по вашей кнопке браузера в расширении Manifest V3. Максимальное количество элементов, которые можно добавить в контекстное меню кнопки браузера верхнего уровня, составляет
menus.ACTION_MENU_TOP_LEVEL_LIMIT, но вы можете добавить любое количество элементов в подменю. - audio
-
Применяется, когда пользователь щелкает правой кнопкой мыши по элементу audio.
- bookmark
-
Применяется, когда пользователь щелкает правой кнопкой мыши по элементу закладки в панели закладок, меню закладок, боковой панели закладок (Ctrl+B) и окне Библиотеки (Ctrl+Shift+B). Последние два поддерживаются начиная с Firefox 66. Требуется разрешение доступа «bookmarks» API-разрешение в манифесте.
- browser_action
-
Применяется, когда пользователь щелкает правой кнопкой мыши по вашей кнопке браузера в расширении Manifest V2. Максимальное количество элементов, которые можно добавить в контекстное меню кнопки браузера верхнего уровня, составляет
menus.ACTION_MENU_TOP_LEVEL_LIMIT, но вы можете добавить любое количество элементов в подменю. - editable
-
Применяется, когда пользователь щелкает правой кнопкой мыши по редактируемому элементу, например, textarea.
- frame
-
Применяется, когда пользователь щелкает правой кнопкой мыши внутри вложенного iframe.
- image
-
Применяется, когда пользователь щелкает правой кнопкой мыши по изображению.
- link
-
Применяется, когда пользователь щелкает правой кнопкой мыши по ссылке.
- page
-
Применяется, когда пользователь щелкает правой кнопкой мыши по странице, но не применяется ни один из других контекстов страницы (например, щелчок не по изображению, вложенному iframe или ссылке).
- page_action
-
Применяется, когда пользователь щелкает правой кнопкой мыши по вашей кнопке страницы. Максимальное количество элементов, которые можно добавить в контекстное меню кнопки страницы верхнего уровня, составляет
menus.ACTION_MENU_TOP_LEVEL_LIMIT, но вы можете добавить любое количество элементов в подменю. - password
-
Применяется, когда пользователь щелкает правой кнопкой мыши по элементу ввода пароля password input element.
- selection
-
Применяется, когда часть страницы выделена.
- tab
-
Применяется, когда пользователь щелкает правой кнопкой мыши по вкладке (точнее, это относится к полосе вкладок или другому элементу пользовательского интерфейса, позволяющему пользователю переключаться с одной вкладки браузера на другую, а не к самой странице).
Начиная с Firefox 63, щелчок по элементу меню на вкладке предоставляет разрешение activeTab для щелкнутой вкладки, даже если это не активная вкладка.
-
Элемент будет добавлен в меню инструментов браузера. Обратите внимание, что это доступно только если вы обращаетесь к
ContextTypeчерезmenusпространство имен. Оно недоступно, если вы обращаетесь к нему черезcontextMenusпространство имен. - video
-
Применяется, когда пользователь щелкает правой кнопкой мыши по элементу video.
Обратите внимание, что «launcher» не поддерживается.
Совместимость с браузерами
| Рабочие столы | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
ContextType |
Да | Да |
55Контекст «editable» не включает поля паролей. Используйте контекст «password» для этого. |
? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
action |
Да | Да | 109 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
bookmark |
НетСм. ошибку 825443. |
НетСм. ошибку 825443. |
59 | ? | НетСм. ошибку 825443. |
Нет | ? | ? | Нет | ? | Нет | ? |
browser_action |
Да | Да | 53Контекст «editable» не включает поля паролей. Используйте контекст «password» для этого. |
? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
launcher |
Да | Да | 48 | ? | Да | Нет | ? | ? | Нет | ? | Нет | ? |
page_action |
Да | Да | 53 | ? | Да | 14 | ? | ? | Нет | ? | Нет | ? |
password |
Нет | Нет | 53 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
tab |
Нет | Нет | 53 | ? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
tools_menu |
Нет | Нет | 56Доступно только вmenus.ContextType, а не в contextMenus.ContextType. |
? | Нет | Нет | ? | ? | Нет | ? | Нет | ? |
Примечание: Этот 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/ContextType