Lightning Experience の getAllUtilityInfo()
すべてのユーティリティの状態を utilityInfo オブジェクトの配列として返します。
引数
なし。
サンプルコード
このコンポーネントにはボタンがあり、押すと、すべての utilityInfo オブジェクトが取得され、ID 順で最初のユーティリティが開きます。
コンポーネントコード:
1<aura:component implements="flexipage:availableForAllPageTypes" access="global" >
2 <lightning:utilityBarAPI aura:id="utilitybar" />
3 <lightning:button label="Get All Utility Info" onclick="{! c.getAllUtilityInfo }" />
4</aura:component>コントローラコード:
1({
2 getAllUtilityInfo : 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})応答
このメソッドは、成功時に次の項目が含まれる utilityInfo オブジェクトの配列に解決される Promise を返します。
| 名前 | 型 | 説明 |
|---|---|---|
| id | string | ユーティリティの ID。 |
| isLoaded | boolean | ユーティリティが読み込まれるかどうか。 |
| utilityLabel | string | ユーティリティの表示ラベル。 |
| utilityIcon | string | ユーティリティのアイコンの SLDS アイコン ID。 |
| utilityHighlighted | boolean | ユーティリティが強調表示されるかどうか。 |
| utilityVisible | boolean | ユーティリティが表示されるかどうか。 |
| panelHeaderLabel | string | ユーティリティパネルの表示ラベル。 |
| panelHeaderIcon | string | ユーティリティパネルのアイコンの SLDS アイコン ID。 |
| panelHeight | integer | ユーティリティパネルの高さ (ピクセル単位)。 |
| panelWidth | integer | ユーティリティパネルの幅 (ピクセル単位)。 |