Hide all default Firefox menu items in favor of providing a custom context menu UI.
The overrideContext method will cause the matching menu items from this extension to be shown instead of the default menu. This method should be called from a contextmenu DOM event handler, and only applies to the menu that opens after this event.
This interface requires the menus.overrideContext permission.
Syntax
browser.menus.overrideContext(
contextOptions
)
Parameters
-
contextOptions
-
object. Options for how the context menus will be overridden.
showDefaults Optional
-
boolean. Whether to also include default menu items in the menu.
context Optional
-
string. ContextType to override, to allow menu items from other extensions in the menu. Currently only 'bookmark' and 'tab' are supported. showDefaults cannot be used with this option.
bookmarkId Optional
-
string. Required when context is 'bookmark'. Requires 'bookmark' permission.
tabId Optional
-
integer. Required when context is 'tab'. Requires 'tabs' permission.
Examples
Open the tab context menu on your custom UI, in this case:
document.addEventListener(
"contextmenu",
(event) => {
const foo = event.target.closest(".foo");
if (foo) {
browser.menus.overrideContext({
context: "tab",
tabId: parseInt(foo.dataset.tabId),
});
}
},
{ capture: true }
);
See this blog post for more details.
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
overrideContext |
No |
No |
64 |
? |
No |
No |
? |
? |
No |
? |
No |
? |