« Documentation Home

BrowserTab.browserWindow

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