Lightning コンポーネント開発者ガイド
jLightning Out の連動関係
Lightning Out を使用して Lightning コンポーネントアプリケーションが初期化されるときに、Lightning Out はアプリケーション内のコンポーネントの連動関係を読み込みます。これを効率的に行うには、事前にコンポーネントの連動関係を指定して、Lightning Out の起動時に定義を一度に読み込めるようにする必要があります。
連動関係を指定するメカニズムが、Lightning 連動関係アプリケーションです。連動関係アプリケーションは、単なる <aura:application> で、いくつかの属性と <aura:dependency> タグによる連動関係コンポーネントの説明が含まれています。Lightning 連動関係アプリケーションは、ユーザが直接使用するために実際にリリースされるアプリケーションではありません。Lightning 連動関係アプリケーションは、Lightning Out の連動関係を指定するためだけに使用します (または、Lightning Out を内部で使用する Lightning Components for Visualforce の連動関係を指定)。
1<aura:application access="GLOBAL" extends="ltng:outApp">
2 <aura:dependency resource="c:myAppComponent"/>
3</aura:application>- アクセス制御を GLOBAL に設定する。
- ltng:outApp または ltng:outAppUnstyled から拡張する。
- $Lightning.createComponent() へのコールで参照されているすべてのコンポーネントを連動関係としてリストする。
この例では、<c:myAppComponent> は、$Lightning.createComponent() を使用して 発信元サーバ 上に作成しようとしている Lightning コンポーネントアプリケーションの最上位コンポーネントです。$Lightning.createComponent() を使用してページに追加する異なるコンポーネントについてそれぞれ連動関係を作成します。
スタイル設定の連動関係の定義
Lightning Out アプリケーションをスタイル設定するために、Salesforce Lightning Design System とスタイル設定なしという 2 つのオプションがあります。Lightning Design System スタイル設定はデフォルトであり、Lightning Out は、現在のバージョンの Lightning Design System を、Lightning Out を使用しているページに自動的に含めます。Lightning Design System リソースを除外し、スタイルを柔軟に制御し、可能であれば発信元サーバのスタイル設定と一致させるには、ltng:outApp ではなく ltng:outAppUnstyled から拡張するように連動関係アプリケーションを設定します。
使用上の注意
Lightning 連動関係アプリケーションは、通常の Lightning アプリケーションではないため、そのようには扱わないでください。Lightning 連動関係アプリケーションは、Lightning Out アプリケーションの連動関係を指定するためだけに使用します。
- Lightning 連動関係アプリケーションにはテンプレートを追加できません。
- Lightning 連動関係アプリケーションのボディに追加するコンテンツは表示されません。