Navigate 関数および Back 関数
Navigate 関数と Back 関数に引数を追加し、Power Apps アプリでユーザー インターフェイスを拡張する方法を見てみましょう。 構文では、角括弧はオプションのパラメーターを示します。
Navigate 関数
Navigate 構文の内訳は次のとおりです。
Navigate(ScreenName, ScreenTransition.TransitionType, {ContextRecord: NewValue})
ScreenName(必須) - 表示する画面。ScreenTransition(オプション) - 現在の画面と次の画面の間で使うビジュアルの切り替えです。 省略した場合、既定値はScreenTransition.Noneになります。ContextRecord(オプション) - 1 つ以上のコンテキスト変数名とその値を含むレコード。 このレコードは、新しい画面のコンテキスト変数を設定または更新します。
どの画面に移動するのかを示す最初のパラメーターを指定する必要があります。 2 番目のパラメーターで、必要に応じて移行効果を制御します。 3 番目のパラメーターを使用すると、コンテキスト値を新しい画面に渡すことができます。
Back 関数
Back 関数の構文は次のとおりです。
Back([ScreenTransition])
-
ScreenTransition(オプション): 前の画面に戻るときに使用する視覚的な遷移。 既定では、これは現在の画面に到達するために使用される移行の逆です。
Back 関数には括弧を含める必要があります (Back())。
Back 関数は、前に表示した画面にユーザーを戻します。 Power Apps は、画面遷移などのナビゲーション履歴を保持します。 Back を使用すると、Power Apps は遷移を逆にします (特定の遷移が定義されていない限り)。
画面遷移
画面遷移は、Navigate 関数と Back 関数の両方で使用できます。 使用できるオプションは以下です。
ScreenTransition.Cover: 新しい画面が右から左にスライドして、現在の画面をカバーします。ScreenTransition.CoverRight: 新しい画面が左から右にスライドして表示されます。ScreenTransition.Fade: 現在の画面がフェードアウトし、新しい画面が表示されます。ScreenTransition.None(既定値) すぐに新しい画面に切り替わります。ScreenTransition.UnCover: 現在の画面が右から左にスライドします。ScreenTransition.UnCoverRight: 現在の画面が左から右にスライドします。
例
Navigate と Back の両方に対して遷移を使用する式の例を、次のテーブルでいくつか紹介します。 この表には、Navigate の例における UpdateContextRecord パラメーターの一部も含まれているので、自身のアプリでそれらがどのように見えるかをビジュアル化することができます。
| 数式 | 説明 | 結果 |
|---|---|---|
Navigate(Details) |
遷移やコンテキストの変更なしに Details 画面に移動します。 |
Details 画面がすぐに表示されます。 |
Navigate(Details, ScreenTransition.Fade) |
Fade 遷移を使用して Details 画面に移動します。 |
現在の画面が Details 画面にフェードインします。 |
Navigate(Details, ScreenTransition.Fade, {ID: 12}) |
Fade 遷移を追加し、ID コンテキスト変数を設定します。 |
ID が 12 に設定されて、Details 画面が表示されます。 |
Navigate(Details, ScreenTransition.Fade, {ID: 12 , Shade: Color.Red}) |
Fade の遷移を使用して Details 画面を表示します。
ID コンテキスト変数の値を 12に更新します。
Shade コンテキスト変数の値を Color.Redに更新します。 |
現在の画面がフェード アウトして、Details 画面が表示されます。
Details 画面上のコンテキスト変数 ID が 12 に設定され、コンテキスト変数 Shade が Color.Red に設定されます。
Details 画面でコントロールの Fill プロパティを Shade に設定すると、そのコントロールは赤で表示されます。 |
Back() |
逆遷移を使用して前の画面に戻ります。 | Power Apps は前回の遷移を元に戻して、前の画面を表示します。 |
Back(ScreenTransition.Cover) |
Cover 遷移を使用して前の画面に戻ります。 |
現在の画面にどのように入ったかに関係なく、Cover 遷移を使用します。 |
要約すると、Navigate と Back は、制御を強化するためのパラメーターをサポートします。 Navigate を使用すると、ユーザーを別の画面に誘導したり、遷移を適用したり、コンテキスト変数を設定したりできます。 Back 関数を使用すると、既定の遷移または指定された遷移による逆方向のナビゲーションが可能になります。
これまで、OnSelect プロパティを使用して画面ナビゲーションを有効にしてきました。 次のユニットでは、アプリ ナビゲーションを実装する追加の方法について説明します。