« Documentation Home

Popup.href

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:

A URL reference to the page to pop up; this page will pop up when the user clicks on an ExtensionUIItem; editing the href attribute while the popup is open will close the popup. Note that this attribute is set in the background script as part of the ToolbarUIItemProperties object. See the Browser Toolbar guide.

Syntax:

DOMString href

Example:

//
// The background process (e.g. '/background.js'). 
//

// Set options for the button
var UIItemProperties = {
  disabled: false,
  title: 'Opera Extension',
  icon: 'images/icon_18.png',
  popup: {}
};

// Set the popup's height to 480 pixels
UIItemProperties.popup.href = 'popup.html';

// Create the button and add it to the toolbar
var button = opera.contexts.toolbar.createItem(UIItemProperties);
opera.contexts.toolbar.addItem(button);