opera.contexts.menu.createItem()

By Opera Software

From Opera 15 onward, Opera 11 & 12’s extension format is no longer supported, and instead, we’ve switched to Chromium’s extension model. Check out our new documentation for developing extensions for Opera 15 and higher and start building your own extensions.

Description

This method creates a MenuItem from a given property object. Note: The item can only be used within the MenuContext that it is created in.

Parameters:

• properties: The MenuItemProperties to use when creating the MenuItem.

The available properties include:

• contexts
• disabled
• documentURLPatterns
• icon
• id
• onclick
• targetURLPatterns
• title
• type

Syntax:

MenuItem createItem (<MenuItemProperties> properties)

Example:

The example below creates and adds an item to the context menu. When it's clicked, the current page's URL is shown in the console.

<!--
  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)
//

// Check the Context Menu API is supported
if (opera.contexts.menu) {
  var menu = opera.contexts.menu;
  // Create a menu item properties object
  var itemProps = {
    title: 'Context Menu Example',
    onclick: function(event) {
      console.log('Menu item clicked on ' + event.pageURL);
    }
  }

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

This article is licensed under a Creative Commons Attribution 3.0 Unported license.