Lightning Out の連動関係

Lightning Out を使用して、リリースされるコンポーネントを記述する特別なスタンドアロン Aura 連動関係アプリケーションを作成します。

スタンドアロン Aura 連動関係アプリケーションは、単なる <aura:application> で、いくつかの属性と <aura:dependency> タグによる連動コンポーネントの説明が含まれています。スタンドアロン Aura 連動関係アプリケーションは、ユーザが直接使用するために実際にリリースされるアプリケーションではありません。スタンドアロン Aura 連動関係アプリケーションは、Lightning Out の連動関係を指定するためにのみ使用します。

このスタンドアロン Aura 連動関係アプリケーションは、デフォルトの c 名前空間の myAppComponent Lightning Web コンポーネントを使用します。

Aura アプリケーションの Lightning Web コンポーネントまたは Aura コンポーネントを参照するには、<namespace:camelCaseComponentName> の命名規則を使用します。

スタンドアロン Aura 連動関係アプリケーションは、次の操作を実行する必要があります。

アクセス制御を GLOBAL に設定する。
ltng:outApp または ltng:outAppUnstyled から拡張する。
$Lightning.createComponent() へのコールで参照されているすべてのコンポーネントを連動関係としてリストする。

この例では、<c:myAppComponent> は、$Lightning.createComponent() を使用して発信元サーバ上に作成しようとしている最上位の Lightning Web コンポーネントです。$Lightning.createComponent() を使用してページに追加する各コンポーネントについて連動関係を作成します。

最上位コンポーネント内で使用されている他のコンポーネントについて心配する必要はありません。フレームワークによって、子コンポーネントの連動関係解決が処理されます。

スタンドアロン Aura 連動関係アプリケーションは、通常の Aura アプリケーションではないため、そのようには扱わないでください。Lightning 連動関係アプリケーションは、Lightning Out アプリケーションの連動関係を指定するためだけに使用します。

特に、次の点に注意してください。

スタンドアロン Aura 連動関係アプリケーションにはテンプレートを追加できません。
スタンドアロン Aura 連動関係アプリケーションの本体に追加するコンテンツは表示されません。

Lightning Out アプリケーションをスタイル設定するために、Salesforce Lightning Design System とスタイル設定なしという 2 つのオプションがあります。Lightning Design System スタイル設定はデフォルトであり、Lightning Out は、現在のバージョンの Lightning Design System を、Lightning Out を使用しているページに自動的に含めます。Lightning Design System リソースを除外し、スタイルを柔軟に制御し、可能であれば発信元サーバのスタイル設定と一致させるには、ltng:outApp ではなく ltng:outAppUnstyled から拡張するように連動関係アプリケーションを設定します。

関連トピック