Newer Version Available

This content describes an older version of this product. View Latest

setTabStyle()

Sets a cascading style sheet (CSS) on the specified tab. If a tab is not specified, the CSS is set on the enclosing tab. Use this method to customize a tab’s look and feel. This method is only available in API version 28.0 or later.

Syntax

1sforce.console.setTabStyle(style:String, tabId:String, (optional)callback:Function)

Arguments

Name Type Description
style string A CSS specification string used to style the tab. If null or undefined, the tab’s default style is used.
tabId string The ID of the tab on which to set the style. If null or undefined, the enclosing tab’s ID is used.
callback function JavaScript method that’s called upon completion of the method.

Sample Code–Visualforce

1<apex:page>
2    <A HREF="#" onClick="testSetTabStyle();return false">
3         Click here to change the enclosing tab’s background color to red</A> <BR/>
4    <A HREF="#" onClick="testResetTabStyle(); return false;">
5         Click here to reset the enclosing tab’s style</A>
6
7    <apex:includeScript value="/support/console/28.0/integration.js"/>
8    <script type="text/javascript">
9        function checkResult(result) { 
10            if (result.success) {
11               alert('Tab style set successfully!');
12            } else {
13               alert('Tab style cannot be set!');
14            }
15    }
16        function testSetTabStyle() {
17            sforce.console.setTabStyle('background:red;', null, checkResult);
18    }
19        function testResetTabStyle() {
20            sforce.console.setTabStyle(null, null, checkResult);
21    }
22    </script>
23</apex:page>

Response

This method is asynchronous, so it returns its response in an object in a callback method. The response object contains the following field:

Name Type Description
success boolean true if setting the tab’s style was successful, false if setting the tab’s style wasn’t successful.

If this method is called without passing in a tab ID, the tab in which the Visualforce page is enclosed is used. If there isn’t an enclosing tab, the error message Cannot get a workspace or view tab from the given ID displays in the browser’s developer console.

Note