MenuEvent.documentURL

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 documentURL attribute is the URL of the containing frame for the element that was clicked. If the element is not within a frame, this attribute will be set to the URL of the top-level document of the current web page, which is equivalent to MenuEvent.pageURL.

Syntax:

readonly DOMString documentURL

Example:

In this example, a menu item is added to the context menu for any domain and any element. When the menu item is clicked, the current element's containing frame will open in a new tab. If there is no containing frame, the current page will open in a new tab.

<!--
  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. '/background.js').
//

if (opera.contexts.menu) {
  var menu = opera.contexts.menu;

  // Create a menu item properties object
  var itemProps = {
    contexts: ['all'],
    title: 'Open frame in new tab',
    onclick: function(event) {
      // Create a tab properties object
      var tabProps = {
        url: event.documentURL
      };

      // 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);
}

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