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

基本的なナビゲーション

pageReference JavaScript オブジェクトは、ページの URL を表します。URL を直接解析または作成する代わりに、pageReference を使用できます。この方法を使用すれば、Salesforce が今後 URL 形式を変更することがあっても、ナビゲーションの破損を避けられます。

次のリソースを使用して、アプリケーションのナビゲーションを簡易化します。これらのリソースを使用するコンポーネントの URL は大文字と小文字を区別します。例は「コンポーネントライブラリ」を参照してください。

lightning:navigation

ページまたはコンポーネントに移動するには、lightning:navigationnavigate() メソッドを使用します。これは navigateTo* イベントの代替となる方法で、両方ともサポートされています。

コンポーネントで URL を���成するには、lightning:navigationgenerateUrl() メソッドを使用して URL を解決します。

generateUrl() は Promise を返します。Promise は生成された URL でコールバックします。

メモ

lightning:isUrlAddressable
URL を介して直接コンポーネントに移動できるようにするには、コンポーネントに lightning:isUrlAddressable インターフェースを追加します。

コンポーネントへの直接移動では、pageReference および lightning:isUrlAddressableforce:navigateToComponent イベントの代わりに使用します。force:navigateToComponent イベント情報の対応付けプロトコルとは異なり、ナビゲーションディスパッチシステムを使用して pageReference 属性のみが入力されます。情報は、参照先ページ参照の state プロパティを使用してアドレス指定されたコンポーネントに渡されます。lightning:isUrlAddressable は、参照先コンポーネントの属性を自動的に設定しません。v.pageReference.state からパラメータを取得し、参照先コンポーネントの init ハンドラを使用して手動で設定します。

ヒント

pageReference は、ページ種別および対応する属性を記述する、明確に定義された構造を提供します。pageReference では次のプロパティがサポートされています。

プロパティ 説明 必須かどうか
type String pageReference 型の API 参照名 (例: standard__objectPage)。 Y
attributes Object ページ定義で指定された各属性の値 (例: objectAPIName または actionName)。 Y
state Object Lightning Experience での URL のクエリ文字列に関連付けられているパラメータ (filterName など)。ルーティングフレームワークは、ページを表示するのに state には依存しません。

Lightning コミュニティは state プロパティをサポートしません。

メモ