ページ・フローとライフサイクルの理解

ページ・フローは、ページ間で情報がどのように転送されるかを管理します。ページ・ライフ・サイクルは個々のページの状態を管理します。

ページには定義されたライフサイクルがあり、ライフサイクルの一環としてトリガーされる特定のイベントを聴くことができます。ページ・ライフ・サイクル・イベントの例は、enterとbeforeExitです。

1つ以上のページがページ・フローを形成します。フロー内で、ページ間のナビゲーションを設定できます。

ナビゲーション操作は、内部または外部のどちらでもかまいません。内部ナビゲーション・アクションは、ナビゲートするページのIDと、そのページに指定されたパラメータで構成されます。外部ナビゲーション・アクションは、外部URLによって定義されます。これらのアクションは、ページ・モデルで定義されています。

また、アプリケーションにはライフサイクルとフローがあります。アプリケーションには複数のページ・フローを含めることができます。

ページのライフサイクル

個々のページは、出入り時にライフサイクル状態を定義し、各状態にトリガーがあります。一部の州では、トリガーにレスポンスしてアクション・チェーンを提供できます。他の州は内部的なものですが、システム内で何が起きているのか、いつ起きるのかを説明します。

イベント	適用対象	ナビゲーションを取消可能	戻り値	説明
`vbBeforeEnter`	ページ	はい	ナビゲーションを取り消すにはなしまたは`{ cancelled: true }`	ページに移動する前にページに送出されます。 Visual Builderは、このページにナビゲートしますが、まだナビゲーションを開始しておらず、前のページの状態を分解していません。開発者は、プロパティ`cancelled`が`true`に設定されているオブジェクトを返すことで、このイベントへのナビゲーションを取り消すことができます(たとえば、ユーザーにこのページへのアクセス権限がない場合)。開発者は、かわりに別のページにユーザーをリダイレクトすることもできます(ユーザーをログイン画面に移動するなど)。この状態が終了すると、前のページの状態が破棄されます。ページ状態は使用できません。次の変数スコープを使用できます: `$application`: すべてのアプリケーション変数 `$flow`: すべての親フロー変数 `$parameters`: URLからのすべてのページ入力パラメータ
`vbEnter`	ページまたはフロー	いいえ	なし	すべてのコンテナ・スコープ変数が追加され、デフォルト値、URLパラメータの値または永続値に初期化された後、ディスパッチされます。次の変数スコープを使用できます: `$application`: すべてのアプリケーション変数 `$flow`: すべての親フロー変数 `$page`: すべてのページ変数この状態は、一般的に同時に発生するデータ・フェッチをトリガーするために使用されます。
`vbBeforeExit`	ページ	はい	ナビゲーションを取り消すにはなしまたは`{ cancelled: true }`	ページを終了する前にページにディスパッチされました。開発者は、`cancelled`が`true`に設定されているプロパティを持つオブジェクトをリスナー・チェーンに戻すことで、このイベントに対するナビゲーションを取り消すことができます。これは、ユーザーがページを終了する前にページを保存する必要がある場合に役立ちます。
`vbExit`	ページまたはフロー	いいえ	なし	ページの終了時にディスパッチされます。このイベントを使用して、ページを終了する前にリソースをクリーンアップできます。

ページ・ナビゲーション

アプリケーション内のすべてのページには名前があり、指定して変更することができます。ページ・フロー内でページ名を使用して、あるページから別のページにナビゲートします。

ナビゲート・アクションを構成するには、次のパラメータを指定します:

ナビゲートするページ、またはその値に解決される式
必須入力パラメータおよび使用するオプション入力パラメータの値。 (ページ入力パラメータの値のみを設定できます。)

次の2つの結果が考えられます:

ナビゲーションは成功しました
移動先のページからナビゲーションが取り消されました