Salesforce Console Developer Guide
jNewer Version Available
setTabHighlighted() for Lightning Experience
Highlights the specified tab with a different background color and a badge. When you
close and reopen a Lightning console app it remembers your open workspace tabs and subtabs, but it
does not remember whether a tab was highlighted. This method works only in
Lightning console apps.
Arguments
| Name | Type | Description |
|---|---|---|
| tabId | string | The ID of the tab to be highlighted. |
| highlighted | boolean | Whether the tab is highlighted. Makes a utility more prominent by giving it a different background color. |
Sample Code
This component has a button that, when pressed, sets the focused tab as highlighted.
Component code:
1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2 <force:workspaceAPI aura:id="workspace" />
3 <lightning:button label="Set Focused Tab Highlighted" onclick="{! c.setFocusedTabHighlighted }" />
4 </aura:component>Controller code:
1({
2 setFocusedTabHighlighted : function(component, event, helper) {
3 var workspaceAPI = component.find("workspace");
4 workspaceAPI.getFocusedTabInfo().then(function(response) {
5 var focusedTabId = response.tabId;
6 workspaceAPI.setTabHighlighted({
7 tabId: focusedTabId,
8 highlighted: true
9 });
10 })
11 .catch(function(error) {
12 console.log(error);
13 });
14 }
15})Response
This method returns a promise that, upon success, returns a
tabInfo object representing the modified tab. A
tabInfo object is a JSON array of
information about a workspace tab, with nested arrays of information on each subtab.
This is the structure of a tabInfo
object.
1{ tabId: string,
2 active: boolean,
3 pinned: boolean,
4 closeable: boolean,
5 highlighted: boolean,
6 title: string,
7 icon: string (SLDS iconKey),
8 iconAlt: string,
9 recordId: string,
10 url: string (URL),
11 subtabs: [
12 {
13 tabId: string,
14 active: boolean,
15 pinned: boolean,
16 closeable: boolean,
17 highlighted: boolean,
18 title: string,
19 icon: string (SLDS iconKey),
20 iconAlt: string,
21 recordId: string,
22 url: string (URL),
23 isSubtab: boolean,
24 parentTabId: string,
25 customTitle: string,
26 customIcon: string (URL),
27 customIconAlt: string
28 },
29 { ... }
30 ],
31 isSubtab: boolean,
32 parentTabId: string,
33 customTitle: string,
34 customIcon: string (URL),
35 customIconAlt: string
36}