MenuItem.documentURLPatterns

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:

The documentURLPatterns attribute is an array of rules specifying which domains a menu item should be visible on. If this attribute is null (default) or an empty array then the menu item will appear on all domains. Note that * can be used as a wildcard.

Syntax:

DOMString[] documentURLPatterns

Example:

The following example creates an item in the context menu only for pages in the opera.com domain.

<!--
  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: 'Translate this page',
    documentURLPatterns: [
      'http://opera.com/*',
      'https://opera.com/*',
      'http://*.opera.com/*',
      'https://*.opera.com/*'
    ],
    onclick: function(event) {
      doTranslate(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.