« Documentation Home

BrowserTabGroup.close()

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 close() method provides a way to close a browser tab group along with all browser tabs within the associated tab collection.

Parameters:

None

Syntax:

void close ()

Example:

The following example creates a button on the browser toolbar. When the button is clicked, the collapsed state of all tab groups is checked and any collapsed groups are closed.

//
// 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() {
    try {
      // Get all the tab groups
      var groups = opera.extension.tabGroups.getAll();
      
      // Loop through the groups
      for (var i = 0, len = groups.length; i < len; i++) {
        // If a group is collapsed, close it
        if (groups[i].collapsed === true) {
          groups[i].close();
        }
      }
      
    } catch(e) {}
    
  }
};

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