BrowserTabGroup.update()

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 update() method provides a way to update the properties of a browser tab group.

Parameters:

  • properties: The new properties to use for updating the tab group.

Syntax:

void update (BrowserTabGroupProperties properties)

Example:

The following example creates a button on the browser toolbar. When the button is clicked, a tab group is created containing two tabs. Then the new tab group is collapsed.

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

    // Collapse the new tab group
    tabGroup.update({collapsed: true});
  }
};

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

  • photo

    drworm

    Sunday, October 14, 2012

    There is a bug where a newly created tabGroup cannot be expanded oncreate. I.e.

    opera.extension.tabGroups.oncreate = function (e) {
    e.tabGroup.update({collapsed : false});
    }

    The tab groups behaves as though it's expanded without actually displaying all the tabs (i.e. the arrows indicates the tab is expanded, and if you click it, it flips to contracted requirign you to click it again before the group expands).

    I've also tried this with tabs.onmove to detect the creation of a group and the same issue occurs.
No new comments accepted.