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

Lightning Experience の openUtility()

ユーティリティを開きます。ユーティリティがすでに開いている場合、このメソッドの影響はありません。一度に開くことができるユーティリティは 1 つのみです。別のユーティリティがすでに開いている場合、最小化されます。

引数

名前 説明
utilityId string 開くユーティリティの ID。ユーティリティ内からコールする場合は省略可能。

サンプルコード

ユーティリティバーで使用される 1 列の Lightning ページにこのコンポーネントが追加されている場合、ボタンを押すとユーティリティが開きます。

コンポーネントコード:

1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2    <lightning:utilityBarAPI aura:id="utilitybar" />
3    <lightning:button label="Open Utility" onclick="{! c.openUtility }" />
4</aura:component>

コントローラコード:

1({
2    openUtility : function(component, event, helper) {
3        var utilityAPI = component.find("utilitybar");
4        utilityAPI.openUtility();
5    }
6})

この例では、utilityId 項目を使用して、ユーティリティの外部からユーティリティを開きます。

コンポーネントコード:

1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2    <lightning:utilityBarAPI aura:id="utilitybar" />
3    <lightning:button label="Open First Utility" onclick="{! c.openFirstUtility }" />
4</aura:component>
コントローラコード:
1({
2    openFirstUtility : function(component, event, helper) {
3        var utilityAPI = component.find("utilitybar");
4        utilityAPI.getAllUtilityInfo().then(function(response) {
5            var myUtilityInfo = response[0];
6            utilityAPI.openUtility({
7                utilityId: myUtilityInfo.id
8            });
9       })
10        .catch(function(error) {
11            console.log(error);
12        });
13    }
14})

応答

このメソッドは、成功時に true に解決される Promise を返します。