opera.extension.tabGroups.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 group, either globally or within the context window. When the create() method is invoked, the following happens:

1. If this is the global tab group manager, a tab group is created using tabs, properties and before as the arguments, if provided.
2. If this is a window tab group manager, a tab group is created within the context window using tabs, properties and before as the arguments, if provided.

Parameters:

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

Syntax:

BrowserTabGroup create (Array[] tabs, optional BrowserTabGroupProperties properties, optional BrowserTabGroup before)

BrowserTabGroup create (Array[] tabs, optional BrowserTabGroupProperties properties, optional BrowserTab before)

Example:

The following example creates a button on the browser toolbar. When the button is clicked, a tab group is created containing two tabs with the specified URLs.

//
// 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 two tabs with specified URLs
    var tab1 = opera.extension.tabs.create({url: 'http://www.reddit.com/'});
    var tab2 = opera.extension.tabs.create({url: 'http://www.digg.com/'});

    // Create a tab group containing the above two tabs
    var tabGroup = opera.extension.tabGroups.create([tab1, tab2]);
  }
};

// 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.