MenuItem.contexts

This functionality has not landed in a stable Opera version yet, but you can use it already in Opera Next.

Description:

The contexts attribute is used to define the list of contexts that this context menu item will appear in. The list of valid context values for this attribute include all, page, frame, selection, link, editable, image, video and audio. The default value is an array with a single entry of page.

Syntax:

DOMString[] contexts

Example:

The following example creates an item in the context menu to open links in private tabs. In other words, the "Open link in private tab" item will appear only when a link is right-/Ctrl-clicked.

<!-- 
  The configuration file ('config.xml').
-->
<?xml version='1.0' encoding='utf-8'?>
<widget xmlns="http://www.w3.org/ns/widgets">
    ...
    <feature name="opera:contextmenus"/>
    ...
</widget>

//
// The background process (e.g. index.html)
//

if (opera.contexts.menu) {
  var menu = opera.contexts.menu;
  // Create a menu item properties object
  var itemProps = {
    title: 'Open link in private tab',
    contexts: ['link'],
    onclick: function(event) {
      // Create a tab properties object
      var tabProps = {
        url: event.linkURL,
        private: true
      };

      // Create a tab with the specified properties
      var tab = opera.extension.tabs.create(tabProps);
    }
  }

  // Create a menu item with the specified properties
  var item = menu.createItem(itemProps);
  // Add the menu item to the context menu
  menu.addItem(item);
}