この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Lightning Experience の setTabHighlighted()

指定されたタブを異なる背景色とバッジで強調表示します。Lightning コンソールアプリケーションを閉じてから再度開く場合、開いていたワークスペースタブおよびサブタブは記憶されていますが、タブが強調表示されていたかどうかは記憶されていません。このメソッドは、Lightning コンソールアプリケーションでのみ機能します。

引数

名前	型	説明
tabId	string	強調表示するタブの ID。
highlighted	boolean	タブが強調表示されるかどうか。異なる背景色を設定してユーティリティを強調表示します。
options	object	省略可能。強調表示されるタブの外観を変更する追加オプション。選択可能なオプションは次のとおりです。 `pulse`: スムーズなアニメーションで交互に色が変わります。

サンプルコード

このコンポーネントにはボタンがあり、押すと、フォーカスされているタブが強調表示されます。

コンポーネントコード:

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>

コントローラコード:

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         options: {
10	      pulse: true
11         }
12            });
13        })
14        .catch(function(error) {
15            console.log(error);
16        });
17    }
18})

応答

このメソッドは、成功時に変更されたタブを表す tabInfo オブジェクトに解決される Promise を返します。tabInfo オブジェクトは、ワークスペースタブに関する情報の JSON 配列で、各サブタブに関する情報の配列がネストされています。tabInfo オブジェクトの構造を次に示します。

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     pageReference: object,
12     subtabs: [
13         {
14             tabId: string,
15             active: boolean,
16             pinned: boolean,
17             closeable: boolean,
18             highlighted: boolean,
19             title: string,
20             icon: string (SLDS iconKey),
21             iconAlt: string,
22             recordId: string,
23             url: string (URL),
24             pageReference: object,
25             isSubtab: boolean,
26             parentTabId: string,
27             customTitle: string,
28             customIcon: string (URL),
29             customIconAlt: string
30          },
31          { ... }
32     ],
33     isSubtab: boolean,
34     parentTabId: string,
35     customTitle: string,
36     customIcon: string (URL),
37     customIconAlt: string
38}

Salesforce コンソール開発者ガイド

Lightning Experience の setTabHighlighted()

引数

サンプルコード

応答