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/68.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