入力パラメータとしてのフラグメント変数の有効化
フラグメントを使用するページからフラグメントに値を渡すには、まず必須またはオプションのフラグメントに入力パラメータを定義します。 たとえば、フラグメント変数にデフォルトのプレースホルダー・タイトルを定義し、それをページのパラメータとして有効にできます。 この場合、特定のページでデフォルト値を代替値で上書きすることもできます。
フラグメント変数を入力パラメータとして有効にするには:
- 必要に応じてフラグメントを定義します。たとえば、従業員の連絡先情報を表示する
employee-contact-detailsフラグメントなどです。 次に示すように、フラグメントが見出しコンポーネントを使用しているとします: - フラグメント変数タブで、タイトルの文字列型変数(titleなど)を作成し、入力パラメータとして有効にします。 オプションで、デフォルト値(たとえば、Contact Info)を設定します。
- フラグメント・デザイナに切り替えて、見出しコンポーネントを先ほど作成した変数にバインドします。
employee-contact-detailsフラグメントが使用されているページを開きます(必要に応じて、フラグメントをキャンバスにドラッグ・アンド・ドロップします)。 入力パラメータとしてマークされたフラグメント変数がページで使用可能になります。- ページ(またはコンテナ)で提供されるものにデフォルトのタイトルをカスタマイズできるようになりました。 これを行うには、フラグメントのプロパティ・ペインの入力パラメータで、タイトル入力パラメータ値(Employee Personal Infoなど)を更新します。
ヒント:
このユースケースを拡張して、フラグメント入力パラメータをページ定数にバインドできます。 たとえば、ページ作成者がheadingというページ・レベルの定数を定義している場合、フラグメント入力パラメータが定数にマップされると、バインドされたconstantの値を編集できます。 これを行うには:title入力パラメータで
「変数ピッカーを開く」をクリックし、「ページと定数」でheadingを選択します。- 定数のデフォルト値(About Meなど)が定義されている場合は、そのデフォルト値を使用するか、新しい値を入力します。
式(
$constants.heading)をクリックすると、ページ・レベルの変数エディタに定数の定義を表示できます。
