動的プレースホルダー

DynamicPlaceholder(string placeholderName, int count = 1, int maxCount = 0, int seed = 0)

placeholderName - プレースホルダーの名前。空でない文字列である必要があります。

count - Sitecoreがレンダリングするプレースホルダーの数を指定します。負でない数値である必要があります .

maxCount - 動的に生成されるプレースホルダーの数の上限。負でない数値である必要があります。

seed - 生成されたプレースホルダー キー サフィックスの開始値を計算するために使用される数値。負でない数値である必要があります。

DynamicPlaceholder(string placeholderName, TagBuilder chrome, int count = 1, int maxCount = 0, int seed = 0)

chrome- 動的に生成されたすべてのプレースホルダの各countをラップするHTMLタグを指定するTagBuilderオブジェクト。

DynamicPlaceholder (string placeholderName, Func<DynamicPlaceholderRenderContext, TagBuilder> chromeResolver, int count = 1, int maxCount = 0, int seed = 0)

chromeResolver - 特定の動的プレースホルダーのTagBuilderラッパーを個別に生成する関数。 DynamicPlaceholderRenderContext.

DynamicPlaceholder(string placeholderName, Func<HtmlString, HtmlString> outputModifier, int count = 1, int maxCount = 0, int seed = 0)

outputModifier - 特定のプレースホルダーのHTML出力を受け取り、変更されたHTMLを返す関数。

DynamicPlaceholder(string placeholderName, Func<HtmlString, DynamicPlaceholderRenderContext, HtmlString> outputModifier, int count = 1, int maxCount = 0, int seed = 0)

outputModifier - 特定のプレースホルダー DynamicPlaceholderRenderContextのHTML出力を受け取り、変更されたHTMLを返す関数。

DynamicPlaceholder(DynamicPlaceholderDefinition definition)

definition - 動的プレースホルダーを定義するためのすべてのオプションを集約します

rendering unique suffix - プレースホルダーを含むレンダリングのUID。これにより、異なるレンダリング間でプレースホルダーキーの一意性が保証されます。

unique suffix within rendering - 動的に生成されたプレースホルダーのインデックス番号。最初の数字はSeedと等しくなります。

content-{7a943e27-b649-400c-986d-33d07f0f50ca}-5

content-{7a943e27-b649-400c-986d-33d07f0f50ca}-6

ph_placeholderKey_paramName

例：

名前: ph_column_count; 値: 5. "column" 動的プレースホルダは5つのプレースホルダを生成します。

名前: ph_column_width; 値: 30px

ph_placeholderKey_indexNumber_paramName

例：

名前: ph_column_2_width; value: 50px."width" パラメータは、インデックス2のプレースホルダーが出力修飾子によって処理される間のみ渡されます。

GetRenderingUniqueSuffix

このプロセッサの目的は、プレースホルダー キーをページ全体で一意にすることです。生成されたプレースホルダーを含むレンダリングのUIDを返します。

GetUniqueKeysWithinRendering

このプロセッサの目的は、プレースホルダー キーを具象レンダリング内で一意にすることです。親レンダリング内の動的プレースホルダのインデックス番号を返します。この値は、レンダリング プロセス中に毎回生成されます。最初の値はSeedから取得され、次にインクリメントされます。

AggregatePlaceholderKeys

このプロセッサは、集計プレースホルダー キーを返し、一意のサフィックスとレンダリング内の一意のサフィックスを次の形式でレンダリングします: {placeholder key}-{rendering unique suffix}-{unique suffix within rendering}。たとえば、GridCell-{7a943e27-b649-400c-986d-33d07f0f50ca}-0) です。

デフォルトでは、プレースホルダ設定は最初の動的プレースホルダキーでのみ機能します。

たとえば、動的プレースホルダー @Html.Sitecore().DynamicPlaceholder("column", 2) は次のようになります。

@Html.Sitecore().Placeholder("column-{…}-0")

@Html.Sitecore().Placeholder("column-{…}-1").

ユーザーは、列プレースホルダーに対してのみプレースホルダー設定を定義できます。プレースホルダー設定は、content-{…}-0とcontent-{…}-1の両方に適用できます。特定の一意のプレースホルダー キー ( column-{…}-1など) のプレースホルダー設定を定義しても、Sitecore.Mvc.Pipelines.Response.GetDynamicPlaceholderInitialKey.RemovePlaceholderUniqueKeySuffixプロセッサが有効になっていない限り、効果はありません。

modeをoff: <mvc.getDynamicPlaceholderInitialKey><processor mode="off" type="Sitecore.Mvc.Pipelines.Response.GetDynamicPlaceholderInitialKey.RemovePlaceholderUniqueKeySuffix, Sitecore.Mvc"/></mvc.getDynamicPlaceholderInitialKey> に設定すると、特定の一意のプレースホルダーキーのプレースホルダー設定を定義できますが、動的プレースホルダーの初期キーnot。

@Html.Sitecore().DynamicPlaceholder(…)のそれぞれの独立した呼び出しは、お互いについて何も知りません。そのため、同じ名前の2つの動的プレースホルダーを同じレンダリングに挿入すると、競合が発生します。例：

@Html.Sitecore().DynamicPlaceholder("column", count: 2)

…

@Html.Sitecore().DynamicPlaceholder("column")

なる：

Html.Sitecore().Placeholder("column-{…}-0")

Html.Sitecore().Placeholder("column-{…}-1")

…

Html.Sitecore().Placeholder("column-{…}-0")

この状況で衝突を取り除くには、次のSeedを設定する必要があります。

@Html.Sitecore().DynamicPlaceholder("column", count: 2)

…

@Html.Sitecore().DynamicPlaceholder("column", seed: 10)

なる：

Html.Sitecore().Placeholder("column-{…}-0")

Html.Sitecore().Placeholder("column-{…}-1")

…

Html.Sitecore().Placeholder("column-{…}-10")

Countパラメータは、レンダリング パラメータを使用していつでもオーバーライドできるため、シードがカウント増加の余地で設定されているか、MaxCountを設定する必要があることに注意してください。