Salesforce Console Developer Guide
jNewer Version Available
focusTab() for Lightning Experience
Focuses a workspace tab or subtab.
Arguments
| Name | Type | Description |
|---|---|---|
| tabId | string | ID of the workspace tab or subtab on which to focus. |
| callback | function | JavaScript method called upon completion of the method. Returns a tabInfo object containing information about the focused tab. |
Sample Code
This component has a button that, when pressed, opens a new tab and gives it focus.
Component code:
1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2 <force:workspaceAPIAccess aura:id="workspace" />
3 <lightning:button label="Focus New Tab" onclick="{! c.focusNewTab }" />
4</aura:component>Controller code:
1({
2 focusNewTab : function(component, event, helper) {
3 var workspace = component.find("workspace");
4 workspace.openTab({
5 url: '/sObject/001R0000003HgssIAC/view',
6 label: 'Global Media',
7 callback : function(error, response) {
8 workspace.focusTab({tabId : response});
9 }
10 });
11 },
12})Response
This method is asynchronous, and returns an array of tabInfo objects. 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 title: string,
6 icon: string (SLDS iconKey),
7 iconAlt: string,
8 recordId: string,
9 url: string (URL),
10 subtabs: [
11 {
12 tabId: string,
13 active": boolean,
14 pinned": boolean,
15 closeable": boolean,
16 title: string,
17 icon: string (SLDS iconKey),
18 iconAlt: string,
19 recordId: string,
20 url: string (URL),
21 isSubtab: boolean,
22 parentTabId: string,
23 customTitle: string,
24 customIcon: string (URL),
25 customIconAlt: string
26 },
27 { ... }
28 ],
29 isSubtab: boolean,
30 parentTabId: string,
31 customTitle: string,
32 customIcon: string (URL),
33 customIconAlt: string
34}