opera.extension.tabs.create()

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

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

Comments

No new comments accepted.