BrowserTab.tabGroup

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 readonly tabGroup attribute exposes the context tab group. On getting, the tabGroup attribute returns a BrowserTabGroup object representing the context tab group.

Syntax:

readonly BrowserTabGroup tabGroup

Example:

The following example creates a button on the browser toolbar. When the button is clicked, the tab group for the current tab—if there is one—either expands or collapses.

//
// 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() {
    // Get the currently selected tab
    var thisTab = opera.extension.tabs.getSelected();

    // Get the tab group the tab belongs to, if any
    try {
      var thisGroup = thisTab.tabGroup;

      // If the group is collapsed, expand it, or the other way round
      var expand = (thisGroup.collapsed === false) ? true : false;
      thisGroup.update({collapsed: expand});
    } catch(e) {}
  }
};

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