Lightning コンポーネント開発者ガイド
jPageReference を使用した Lightning Experience および Salesforce モバイルアプリケーションでのナビゲーション
PageReference はページの URL を表す JavaScript オブジェクトです。URL を直接解析または作成する代わりに、PageReference を使用します。この方法を使用すれば、Salesforce が今後 URL 形式を変更することがあっても、ナビゲーションの破損を避けられます。
PageReference は、ページ種別と対応する属性を記述する、明確に定義された構造を提供します。PageReference では次のプロパティがサポートされています。
| プロパティ | 型 | 説明 | 必須かどうか |
|---|---|---|---|
| type | String | ページ定義の API 参照名 (例: standard__objectPage)。 | Y |
| attributes | Object | ページ定義で指定された各属性の値 (例: objectAPIName または actionName)。 | Y |
| state | Object | Lightning Experience での URL のクエリ文字列に関連付けられている追加パラメータ (filterName など)。ルーティングフレームワークは、ページを表示するのに state には依存しません。 |
PageReference オブジェクトには、移動先のページ種別を記述する キー - 値ペアが含まれます。PageReference は次のようになります。
1var pageReference = {
2 type: 'standard__objectPage',
3 attributes: {
4 objectApiName: 'Account',
5 actionName: 'list'
6 },
7 state: {
8 filterName: 'MyAccounts'
9 }
10};次のリソースを使用して、アプリケーションのナビゲーションを簡易化します。例は、「コンポーネントライブラリ (ベータ)」を参照してください。
- lightning:navigation
- コンポーネントで URL を生成するには、lightning:navigation で generateUrl() メソッドを使用して URL を解決します。
ページまたはコンポーネントに移動するには、lightning:navigation で navigate() メソッドを使用します。
これは navigateTo* イベントの代替となる方法で、両方ともサポートされています。
- lightning:isUrlAddressable
- lightning:isUrlAddressable インターフェースを Lightning コンポーネントに追加して、URL で直接コンポーンネントのナビゲーションができるようにします。