動的インタラクションを機能させるためには、管理者と開発者の両方が関与する必要がありますが、最も重要になるのは、トリガとなるイベントのプロパティを定義するカスタムソースコンポーネントです。イベントのメタデータとプロパティをソースコンポーネントに追加して、イベントを Lightning アプリケーションビルダーに公開します。これにより、管理者がイベントの対象とインタラクションを設定できます。
ソースコンポーネントにできるのは Lightning Web コンポーネントのみですが、すべてのコンポーネント (Aura または LWC) を対象にできます。ソースコンポーネントからイベントを公開するには、その .js ファイルで標準 JavaScript CustomEvent を起動します。イベントを検出できるようにするには、ビルダーのプロパティを公開する方法と同様に、コンポーネントの js-meta.xml ファイルで、動的インタラクション専用のメタデータを使用します。
動的インタラクションの概要については、「Salesforce ヘルプ」を参照してください。
Note
動的インタラクションでは、ソースコンポーネントのバンドルの componentName.js-meta.xml ファイルに記述できる 2 つの targetConfig サブタグを使用してイベントを公開します。
eventschemaこれらのサブタグは、対象が lightning__AppPage の targetConfig でのみ使用できます。
Note
取引先リストソースコンポーネントのサンプル js-meta.xml 設定ファイルを次に示します。これには itemselected イベントが含まれ、そのスキーマには .js ファイルで定義される apiName および recordId が含まれます。
1<?xml version="1.0" encoding="UTF-8"?>
2<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
3 <apiVersion>52.0</apiVersion>
4 <isExposed>true</isExposed>
5 <masterLabel>Account List</masterLabel>
6 <targets>
7 <target>lightning__AppPage</target>
8 </targets>
9 <targetConfigs>
10 <targetConfig targets="lightning__AppPage">
11 <property name="apiName" type="String"/>
12 <property name="listViewApiName" type="String"/>
13 <event name="itemselected" label="Item Selected" description="This event fires when an item is selected.">
14 <schema>
15 {
16 "type": "object",
17 "properties": {
18 "recordId": {
19 "type": "string",
20 "title": "Record ID"
21 "description": "Enter an 18-digit record ID."
22 },
23 "apiName": {
24 "type": "string"
25 }
26 }
27 }
28 </schema>
29 </event>
30 </targetConfig>
31 </targetConfigs>
32 <description>meta xml description</description>
33</LightningComponentBundle>type と properties のみが使用されます。スキーマの他の項目はすべて無視されます。type、title、および description のみです。event タグのメタデータは、.js ファイルに対して検証されません。関連トピック
The Japanese Summer '24 guide is now live
j