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

aura:dependency

<aura:dependency> タグでは、フレームワークで簡単に検出できない連動関係を宣言できます。

このフレームワークでは、マークアップで定義されたコンポーネントなどの定義間の連動関係が自動的に追跡されます。これにより、フレームワークが自動的に定義をブラウザに送信できるようになります。ただし、コンポーネントの Javascript コードによって、別のコンポーネントが動的にインスタンス化されたり、コンポーネントのマークアップで直接参照されないコンポーネントが起動されたりする場合は、コンポーネントのマークアップで <aura:dependency> を使用して、連動関係についてフレームワークに明示的に指示します。<aura:dependency> タグを追加することで、コンポーネントなどの定義とその連動関係が必要に応じてクライアントに送信されます。

たとえば、このタグをコンポーネントに追加すると、sampleNamespace:sampleComponent コンポーネントが連動関係としてマークされます。

1<aura:dependency resource="markup://sampleNamespace:sampleComponent" />

コンポーネントのマークアップにこのタグを追加して、イベントを連動関係としてマークします。

1<aura:dependency resource="markup://force:navigateToComponent" type="EVENT"/>

JavaScript コードでイベントを起動し、コンポーネントのマークアップで <aura:registerEvent> を使用してイベントを登録していない場合は、<aura:dependency> タグを使用します。推奨される方法は、<aura:registerEvent> タグの使用です。

<aura:dependency> タグには、次のシステム属性があります。

システム属性 説明
resource コンポーネントが依存するリソース。たとえば、resource="markup://sampleNamespace:sampleComponent" は、sampleNamespace 名前空間の sampleComponent を指します。

ワイルドカード照合では、リソース名でアスタリスク (*) を使用します。たとえば、resource="markup://sampleNamespace:*" は名前空間のすべてに一致し、resource="markup://sampleNamespace:input*" は名前空間の input で始まるすべてに一致します。

一致したすべての定義がフレームワークからクライアントに送信されるため、ワイルドカード照合にアスタリスク (*) を使用することはお勧めしません。ワイルドカード照合では、必要以上の数の定義が送信され、ページの読み込みに時間がかかります。ページの読み込み時間を短縮するには、コンポーネントのマークアップで直接参照されない各定義に <aura:dependency> タグを追加します。

メモ

リソース名の名前空間の部分にアスタリスク (*) を使用しないでください。たとえば、resource="markup://sample*:sampleComponent" はサポートされません。

type コンポーネントが依存するリソースの種別。デフォルト値は、COMPONENT です。

全種別のリソースと一致させるには、type="*" を使用します。

一致したすべての定義がフレームワークからクライアントに送信されるため、ワイルドカード照合にアスタリスク (*) を使用することはお勧めしません。クライアントに送信する定義の種別はできるだけ慎重に選択してください。

メモ

最も一般的に使用される値は、次のとおりです。

  • COMPONENT
  • APPLICATION
  • EVENT

複数の種別には、COMPONENT,APPLICATION のようにカンマ区切りのリストを使用します。