« Documentation Home

BrowserWindow.tabGroups

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 tabGroups attribute exposes a window tab group manager. The tab group manager is an object that implements the BrowserTabGroupManager interface and manages all browser tab groups that are currently open within the context window.

Syntax:

readonly BrowserTabGroupManager tabGroups

Example:

The following example creates a button in the browser toolbar. When the button is clicked, the last focused window is detected. The number of tab groups in the window is then displayed in the button's badge.

//
// 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",
  badge: {
    backgroundColor: '#cc0000',
    color: '#ffffff'
  }
};

// Create the button and add it to the toolbar.
var button = opera.contexts.toolbar.createItem( UIItemProperties );  
opera.contexts.toolbar.addItem(button);

button.addEventListener('click', handleClick, false);

function handleClick() {
  // Get the last focused window
  var win = opera.extension.windows.getLastFocused();
  
  // Get all groups in the window
  var groups = win.tabGroups.getAll();
  
  // Display the number of groups in the button's badge
  button.badge.textContent = groups.length;
}