注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

変数に基づくレイアウト

変数に基づくレイアウトでは、変数を使用してレイアウトコンポーネントの状態を動的に制御できます。これにより、ユーザーのインタラクション、オブジェクトのプロパティ、または関数で定義されたカスタムロジックにユーザーインターフェース要素が反応する、応答性の高いアプリケーションを構築できます。

次のレイアウトコンポーネントは、変数に基づく制御をサポートしています。

  • ページ: 複数ページのモジュールで表示するページを制御します
  • セクション: 表示設定と折りたたみ状態を制御します
  • タブ: 選択するタブを制御します
  • オーバーレイ: オーバーレイの開閉を制御します

変数に基づくページ選択

複数ページのモジュールに文字列変数をバインドして、表示するページを制御できます。変数の値がページIDと一致すると、そのページがアクティブになります。

変数に基づくページ選択を設定するには、次の手順に従います。

  1. 編集モードで左サイドバーからモジュール設定パネルを開きます。
  2. 設定パネルのページで、変数ベースのページ選択設定を見つけます。
  3. 表示するページを制御する文字列変数を選択します。
  4. ページごとに、変数に格納する値と一致する一意のページIDを設定します。

この機能は、URL パラメーターを通じて特定のページにディープリンクする場合、ユーザーの操作に基づいてページ間を移動する場合、またはインターフェース変数を通じて親モジュールからページ選択を制御する場合に役立ちます。

ルーティングが有効な場合は、ページ選択変数のデフォルト値を空にしてください。ルーティングは URL から初期値を設定しますが、デフォルト値が設定されていると、初回表示時にその値で上書きされます。

ページを切り替えるレイアウトイベントは、変数に基づくページ選択用に設定された変数の値を更新しません。イベントによってページが変更されたときに変数を同期させるには、代わりに変数値を設定イベントを使用します。

変数に基づくセクションの条件付き表示設定

セクションにブール変数をバインドして、表示するか非表示にするかを制御できます。デフォルトでは、変数が true と評価されるとセクションは非表示になり、false と評価されると表示されます。変数選択の右側にあるブール値のセレクターを変更すると、このデフォルトの動作を反転できます。

変数に基づくセクションの表示設定を行うには、次の手順に従います。

  1. モジュール内のセクションを選択します。
  2. 条件付き表示設定を見つけてオンにします。
  3. 設定パネルで、次の場合、セクションを非表示にする設定を見つけます。
  4. セクションの表示設定を制御するブール変数を選択します。
  5. 必要に応じて、ブール変数が false のときに非表示になるようにセクションを設定します。

この機能は折りたたみ状態の機能とは異なります。非表示のセクションはレイアウトにまったく表示されませんが、折りたたまれたセクションはヘッダーが引き続き表示され、ユーザーが展開できます。セクションの表示設定を更新するイベントは用意されていません。代わりに変数値を設定イベントを使用します。

変数に基づくセクションの折りたたみ状態

折りたたみ可能なセクションにブール変数をバインドして、展開するか折りたたむかを制御できます。変数が true と評価されると、セクションは折りたたまれます。false と評価されると、セクションは展開されます。

セクションを展開、折りたたみ、または切り替えるレイアウトイベントは、変数に基づく折りたたみ状態用に設定された変数の値を更新しません。イベントによってセクションの状態が変更されたときに変数を同期させるには、代わりに変数値を設定イベントを使用します。

変数に基づく折りたたみ状態を設定するには、次の手順に従います。

  1. モジュール内のセクションを選択します。
  2. 設定パネルで、折りたたみ可能設定を有効にします。
  3. 変数ベースの折りたたみ状態設定を見つけて、ブール変数を選択します。

この機能は、関連するデータが存在する場合にのみセクションを展開する場合や、複数のセクションの展開と折りたたみの動作を連動させる場合に役立ちます。

変数に基づくオーバーレイの開閉状態

オーバーレイにブール変数をバインドして、開くか閉じるかを制御できます。変数が true と評価されると、オーバーレイが開きます。false と評価されると、オーバーレイが閉じます。

オーバーレイを開いたり閉じたりするレイアウトイベントは、変数に基づく開閉状態用に設定された変数の値を更新します。また、閉じたときイベントを設定して、オーバーレイが閉じられたときに上流の変数をリセットしたり、ほかの操作を実行したりすることもできます。

変数に基づくオーバーレイの状態を設定するには、次の手順に従います。

  1. モジュール内のオーバーレイを選択します。
  2. 設定パネルで、変数に基づく開閉状態設定を見つけます。
  3. オーバーレイの状態を制御するブール変数を選択します。

この機能は、イベントに応じてオーバーレイを開く場合、インターフェース変数を通じて親モジュールからオーバーレイの状態を制御する場合、または複数のオーバーレイを連動させる場合に役立ちます。

変数に基づく選択中のタブ

タブコンテナに文字列変数をバインドして、現在選択されているタブを制御できます。変数の値がタブIDと一致すると、そのタブがアクティブになります。この機能は双方向に動作します。タブを選択すると変数が更新され、変数を変更すると対応するタブが選択されます。

ページ選択やセクションの折りたたみ状態とは異なり、選択中のタブを変更するレイアウトイベントも、変数に基づくタブ選択用に設定された変数の値を更新します。

変数に基づくタブ選択を設定するには、次の手順に従います。

  1. モジュール内のタブコンテナを選択します。
  2. 設定パネルで、変数ベースのタブ選択設定を見つけます。
  3. 選択中のタブを制御する文字列変数を選択します。
  4. タブごとに、変数に格納する値と一致する一意のタブIDを設定します。

この機能は、複数のタブコンテナ間でタブの状態を同期する場合、モジュールのインターフェース変数を通じて選択中のタブを URL に保存する場合、またはモジュール内の別の場所で行われたユーザーの操作に基づいてプログラムでタブを変更する場合に役立ちます。