プリセットを使用してコンポーネントを自動的に構成する
コンポーネントプリセットを使用して、互換性のあるページでコンポーネントを自動的に構成します。
コンポーネントプリセットを使用して、事前定義された構成値とイベントマッピングをコンポーネントに適用します。UI ビルダー ページテンプレートには、プリセットがコンポーネント構成値を定義するために使用するコントローラーが含まれています。
プリセットは、事前にビルド済みの構成をコンポーネントプロパティとイベントハンドラーに適用します。これらは、特定のコンポーネントでのみ使用できます。これらは、通常はレコードページに含まれているフィールドを使用してフォームコンポーネントを構成するなど、コンポーネントの一般的なユースケースに基づいています。
プリセットを適用すると、コンポーネントがすぐに動作するように自動的に構成され、ページ作成者のページ作成とメンテナンスが簡素化されます。
プリセットは、ページ作成者に次のようなメリットがあります。
- コンポーネントの複合データとイベントバインディングの処理
- ページの外部で定義されることによる所有コストとメンテナンスの削減
[構成] ペインで、選択したコンポーネントにプリセットを適用するか、代わりに手動で構成するかを選択できます。デフォルトのプリセットは、テンプレートからページが作成された場合、またはプリセットに必要なコントローラーが既にページに追加されている場合に、コンポーネントに自動的に適用されます。プリセットが適用されると、プリセットによって構成されたプロパティまたはイベントが読み取り専用として表示されます。
プリセットによって構成された値は上書きできますが、そうするとコンポーネントの構成とメンテナンスの所有権を引き受けることになります。
データとイベントのバインディング
プリセットには、次へのバインディングを含めることができます。
- コントローラー出力プロパティ (@data)
- イベントペイロード (@payload)
- セッションコンテキスト (@context.session)
- 複雑な式 (クライアント変換)
プリセットには、コントローラーの処理済みイベントへのイベントマッピングを含めることもできます。詳細については、「「Manage actions in UI Builder pages (UI ビルダーページでのアクションの管理)」」を参照してください。
コントローラー
プリセットは、コントローラーを使用してコンポーネントをデータおよびイベントマッピングに接続します。プリセットに必要なコントローラーがまだページにない場合、プリセットは、コントローラーの必要なプロパティを構成してコントローラーを追加することを求めます。コントローラーがページに追加されると、コントローラーに関連付けられたプリセットを持つコンポーネントが、コンポーネントリストでハイライト表示されます。詳細については、「コントローラーを使用した UI ビルダー ページへのデータのバインド (高度な機能)」を参照してください。
コンポーネントプリセットの選択
コンポーネントをページに追加するときに、コンポーネントプリセットを選択します。
始める前に
必要なロール：admin
手順
-
緑色でハイライト表示されたコンポーネントをページに追加します。
緑色でハイライト表示されたコンポーネントには、利用可能なプリセットがあります。
-
コンポーネントは、デフォルトのプリセットを使用して自動的に構成されます。
- オプション:
構成パネルのリストから別のプリセットを選択します。
[削除] を選択すると、プリセットを使用しないようにコンポーネントを構成できます。
- 既存のプリセットを置き換えるには、[続行] を選択します。
コンポーネントプリセットの上書き
コンポーネントプリセットを上書きして、独自のカスタム値を入力します。
始める前に
必要なロール：admin
手順
-
プリセットを含むコンポーネンを選択します。
-
[保存] を選択します。
タスクの結果
構成パネルのフィールドにカスタム値が表示されます。
コンポーネントのリセット
コンポーネントプリセットをデフォルト値にリセットします。
始める前に
必要なロール：admin
手順
-
コンテンツツリーでリセットするコンポーネントを選択します。
-
構成パネルでコンポーネント名を選択します。
-
[コンポーネントをリセット] をクリックします。
タスクの結果
コンポーネントプリセットをデフォルト値にリセットします。