レンダリングバリアントにおけるModelReferenceフィールドレンダラーの使用

SXAにはデフォルトのレンダリングおよび レンダリングバリエー ション( ReferenceやModelフィールドレンダラーを含む)が付属しています。しかし、タイプコレクションのモデルプロパティを処理するには、ModelReferenceフィールドレンダラーを使用する必要があります。

ModelReferenceフィールドレンダラーはレンダリングモデル内の指定されたコレクションを反復処理し、追加のモデルフィールドレンダラーをサブアイテムとして使用してデータを抽出できます。コレクションはアイテムのパススルーフィールドフィールドで指定します。対象となるモデルコレクションプロパティはIEnumerableインターフェースを実装しなければなりません。

標準フィールドレンダラーは、任意の標準フィールドレンダラーを、ModelReferenceフィールドレンダラーの下にネスト方式で使用できます。また、ModelReferenceフィールドレンダラーをネストして、複数のネストされたオブジェクト(階層構造)を持つモデルのコレクションプロパティをターゲットにすることも可能です。これはProduct Bundle - Deprecatedの以下の図に示されています。

以下のクラス図は、ModelReferenceフィールドレンダラーの使い方の例を示しています。図内には、ModelReferenceレンダラーがプロダクトバンドルコンポーネントのデフォルトレンダリングバリアントを反復するために使われる4つのネストされたコレクションがあります。

• ProductBundleRenderingModelはLineItemsコレクションを繰り返します。
• ProductVariantクラスはVariantSelectionsコレクションを反復します。
• BundleVariantsReferenceはValidProductVariantsコレクションを繰り返します。
• OptionsクラスはOptionsコレクションを反復します。
• BundleValueVariantsReferenceはVariantsコレクションを繰り返します。

Scribanテンプレートを修正することで 製品バンドルをカスタマイズ できます。

ModelReferenceレンダラーを使用するには、コレクションプロパティを持つレンダリングモデルクラスを作成する必要があります。モデルクラスはVariantsRenderingModelから継承しなければなりません。

using Sitecore.XA.Foundation.Variants.Abstractions.Models; namespace ProductList.Models { public class ProductListRenderingModel: VariantsRenderingModel { public ICollection Products { get; set; } } }