« Documentation Home

opera.extension.tabs.create()

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 create() method provides a way to create a new browser tab, either globally or within the context window or context tab group. The value returned is based on the following algorithm:

1. If this is the global tab manager, run the algorithm to create a tab using properties and before as the arguments, if provided.
2. If this is a window tab manager, run the algorithm to create a tab within the context window using properties and before as the arguments, if provided.
3. If this is a group tab manager, run the algorithm to create a tab within the context tab group using properties and before as the arguments, if provided.

Parameters:

• properties: The properties of the new tab, such as its url or whether it's private.
• before: The tab or tab group that the new tab should be inserted before, usually to the left.

Syntax:

BrowserTab create (optional BrowserTabProperties properties, optional BrowserTabGroup before)

BrowserTab create (optional BrowserTabProperties properties, optional BrowserTab before)

Example:

The following example creates a button on the browser toolbar. When the button is clicked, a tab is created with the specified URL.

//
// The background process (e.g. index.html) 
//

// Specify the properties of the button before creating it.
var UIItemProperties = {
  disabled: false,
  title: "Example extension",
  icon: "images/icon_18.png",
  onclick: function() {
    // Create a tab with the specified URL
    var tab = opera.extension.tabs.create({url: 'http://dev.opera.com/'});
  }
};

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