« Documentation Home

MenuEvent.documentURL

This documentation relates to Opera's now deprecated .oex Extension API framework for Opera versions <= 12.15 and also provided by our OEX2NEX shim library.

For the latest Opera Extensions API documentation for Opera versions > 12.15 please consult the latest Opera Extensions API documentation online.

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