レンダリングをコピーしてカスタマイズする
スキャフォールディングでカスタム レンダリングを追加する方法について説明します。
SXA では、クローン スクリプトを使用して SXA レンダリングのコピーをすばやく作成できます。レンダリングのクローンを作成することにより、レンダリング定義アイテム、レンダリング パラメーター テンプレート、データソース テンプレート、およびブランチの正確なコピーを作成できます。既存のレンダリングをコピーし、別の名前とスタイルを設定します。これは、たとえば、すべて異なるスタイルの多くのプロモ レンダリングが必要な場合に便利です。
標準の SXA ツールボックス セクションは SXA の更新により上書きされるため、 派生レンダリング用に独自のツールボックス セクションを作成することをお勧めします。これは、SXA に新しいモジュールを追加することで実行できます。
新規モジュールを追加するには:
/sitecore/システム/設定 に移動し、[機能] または [Foundation] を右クリックし、新しいフォルダーを挿入します。
新しいフォルダーを右クリックし、[挿入] をクリックして [モジュール] をクリックします。
名前を入力し、新しいフォルダーの下にモジュールをグループ化します。
レンダリングをコピーしてカスタマイズするには:
使用するレンダリングを複製するには、/sitecore/レイアウト/Renderings/ に移動して、クローンするレンダリングを右クリックします。
[スクリプト] をクリックして [クローン レンダリング] をクリックします。
[派生レンダリングを作成] ダイアログ ボックスの次のフィールドに入力します。
タブ | フィールド | 説明 |
---|---|---|
全般 | 新しいレンダリング名 | 新しいレンダリングの名前を入力します。 |
モジュールに追加 | 新しいレンダリングが属するモジュールを選択します。標準の SXA ツールボックス セクションは SXA の更新によって上書きされるため、派生レンダリング用に独自のモジュールを追加することをお勧めします。 | |
CSS クラスのレンダリング | レンダリングの CSS クラスを入力します。 | |
パラメーター | レンダリング パラメーター | レンダリング パラメーターのコピー モードを選択します。
|
データソース | データソース | データソースのコピー モードを選択します。
|
ビュー | ビュー | ビューのコピー モードを選択します。
|
レンダリング ビューへのパス | ビューの場所を入力します。次に例を示します。
|
これで、サイトのツールボックスに表示されるレンダリングを追加できるようになります。
ツールボックスにレンダリングを追加するには:
サイトのプレゼンテーション フォルダーに移動して、[有効なレンダリング] を右クリックします。
[挿入] をクリックし、[有効なレンダリング] をクリックします。
追加するレンダリングのセクション名を入力して [OK] をクリックします。
作成した新しいセクションをクリックし、[データ] セクションの [編集] をクリックします。
[アイテムを選択] ダイアログ ボックスの [レンダリング] フォルダーで、関連するレンダリングをクリックし、右矢印をクリックして選択したアイテムのリストに移動します。[OK] をクリックします。
新しいレンダリングをエクスペリエンス エディターで使用できるようになりました。