Scribanテンプレートの埋め込みコマースアイテムとオブジェクト
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
埋め込み関数と埋め込みオブジェクトおよびアイテムを使用して、SXA Storefront Scribanテンプレートをカスタマイズできます。
Commerce Foundationレイヤーは、通常のScriban変数と同様に使用できる埋め込みオブジェクトをScribanレンダリング コンテキストに挿入します。これらの埋め込みオブジェクトは、次の図に示すように、正規URLを使用してStorefrontContextとSiteContextのプロパティへのアクセスを提供する場合に特に便利です。

これらのオブジェクトには、次のコードを使用してScribanテンプレートからアクセスします。
o_storefrontcontext.is_storefront_site
o_sitecontext.current_catalog_item
SXA Storefrontは、カタログ アイテムの正規URLを処理するときに使用されるワイルドカード ナビゲーションをサポートしています。抽象化として、現在のカタログ アイテムにアクセスする場合にo_sitecontext.current_catalog_itemを使用し、URLでワイルドカードまたは直接ナビゲーションが使用されているかどうかに関係なくカタログ アイテムを解決できます。また、現在のアイテムがカタログアイテム(カテゴリまたは製品)であるか、通常のページアイテムであるかをすばやく判断することもできます。
埋め込みアイテム
Sitecoreは、コンテンツをアイテム内に保存し、コンテンツ アイテムをScribanランタイム内に埋め込みます。これらのアイテムを使用して、フィールドのコンテンツにアクセスしたり、子または親を取得してアイテム構造を走査したりできます。 Scribanコンテキストに埋め込まれたアイテムとオブジェクトを参照してください。
Contextオブジェクト
コンテキストオブジェクトを使用して複雑なロジックを実装できます。これは、レンダリングする場合に便利です。
-
ページが表示される状況に基づいて異なるコンテンツ。
-
エディター用の追加データですが、ストアフロントサイトへの訪問者には非表示にします。
-
ページの言語によってテキストが異なります。
次の表に、使用可能なコンテキスト オブジェクトを示します。
Contextオブジェクト |
種類 |
価値 |
---|---|---|
o_storefrontcontext |
Sitecore.Commerce.XA.Foundation.Common. Context.IStorefrontContext |
現在のストアフロントのプロパティ、構成、および設定へのアクセスを許可するプロパティと構成。 |
o_sitecontext |
Sitecore.Commerce.XA.Foundation.Common. Context.ISiteContext |
現在のカタログ アイテムと関連プロパティ。また、現在のHTTPコンテキストも含まれます。 |
o_storefrontcontext
o_storefrontcontextオブジェクトはストアフロントコンテキストを決定し、コンポーネントがレンダリングされる要求に関する情報を含みます。
次の表に、o_storefrontcontextコンテキストオブジェクトのプロパティを示します。
財産 |
種類 |
使い |
---|---|---|
文脈 |
Sitecore.Commerce.XA.Foundation.Common. Context. IContext |
HttpContextプロパティにアクセスするためのインターフェイスを提供します。 |
現在のストアフロント |
Sitecore.Commerce.XA.Foundation. Common.Models. CommerceStorefront |
現在のストアフロント サイトを確立します。 |
IsStorefrontApiCallResponseContext |
ブーリアン |
現在のコンテキストがAJAX呼び出し要求であるかどうかを示します。 |
IsStorefrontSite (ストアフロントサイト) |
ブーリアン |
現在のサイトがストアフロント サイトであるかどうかを示します。 |
o_sitecontext
o_sitecontextオブジェクトは、サイトおよびページ固有のプロパティへのアクセスを提供し、現在のストアフロントサイトを決定し、カタログアイテムとHTTPコンテキストを解決します。
次の表に、o_sitecontextコンテキスト オブジェクトの注目すべきプロパティを示します。
財産 |
種類 |
使い |
---|---|---|
文脈 |
Sitecore.Commerce.XA.Foundation.Common. コンテキスト。ICオンテキスト |
HttpContextプロパティにアクセスするためのインターフェイスを提供します。 |
現在のカタログアイテム |
Sitecore.Data.Items.アイテム |
ワイルドカードアプローチが使用されている場合でも、現在選択されているカタログアイテムにアクセスできます。 |
現在のアイテム |
Sitecore.Data.Items.アイテム |
現在のコンテキスト項目を取得または設定します。ダイレクトナビゲーションでは、CurrentCatalogItemと同じです。 |
カテゴリ |
ブーリアン |
CurrentCatalogItemのインスタンスがカテゴリであるかどうかを示す値を取得します。 |
製品である |
ブーリアン |
CurrentCatalogItemのインスタンスがproductであるかどうかを示す値を取得します。 |
項目 |
System.Collections.IDictionary (英語) |
HTTP要求キャッシュ項目のコレクションへのアクセスを提供します。 |
UrlContainsCategory |
ブーリアン |
現在のURLにカテゴリが含まれているかどうかを設定します。 |
バーチャルフォルダ |
糸 |
サイトの仮想フォルダを取得します |