Lightning Aura Components Developer Guide (Lightning Aura コンポーネント開発者ガイド)
jクエリパラメータの追加
URL にクエリパラメータを追加するには、PageReference の state プロパティを更新します。state プロパティのキー - 値ペアは URL クエリパラメータに逐次化されます。クエリパラメータは、ユーザが保存またはブックマークできるページとフォームの具体的な URL を記述します。
state プロパティを使用するときは、次の点に留意してください。
- pageReference オブジェクトを直接変更することはできません。state を更新するには、新しい pageReference オブジェクトを作成し、Object.assign({}, pageReference) を使用して値をコピーします。
- state パラメータは名前空間が設定されている必要が��ります。たとえば、名前空間が abc でパラメータが accountId の管理パッケージは、abc__accountId として表されます。カスタムコンポーネントの名前空間は c__ です。名前空間のないパラメータは、Salesforce が使用するために予約されています。この名前空間の制限は、Winter '19 の重要な更新で導入され、Summer '19 で適用されます。
- PageReference.state のキー - 値ペアは URL クエリパラメータに逐次化されるため、すべての値は文字列でなければなりません。
- state の値を使用するコードは、値を正しい形式で解析する必要があります。
- state オブジェクトの値を削除するには、その値を未定義として定義します。
コンポーネントで lightning:hasPageReference または lightning:isUrlAddressable インターフェースを使用している場合は、必ず変更ハンドラを実装してください。ナビゲーションアクションの対象が同じコンポーネントにマッピングされている場合には、ルーティングコンテナは、コンポーネントを作成し直すのではなく、単純に pageReference 属性値を更新するだけの場合があります。この場合は、変更ハンドラによってコンポーネントが正しく反応するようにしてください。