opera.extension.tabGroups.getAll()

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 getAll() method provides a way to obtain a tab group collection. The value returned is based on the following algorithm:

  1. If this is the global tab group manager, return an array of BrowserTabGroup objects representing each browser tab group that is currently open.
  2. If this is a window tab group manager, return an array of BrowserTabGroup objects representing each browser tab group that is currently open within the context window.

Parameters:

None

Syntax:

BrowserTabGroup[] getAll ()

Example:

The following example creates a button on the toolbar. When the button is clicked, the number of browser tab groups currently open is shown 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() {
  var groups = opera.extension.tabGroups.getAll();
  button.badge.textContent = groups.length;
}

This article is licensed under a Creative Commons Attribution 3.0 Unported license.

Comments

No new comments accepted.