ビューの種類

部分的なビュー

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

大事な

前にアプリを統合した場合は、従来の ASP.NET Core Rendering SDKバージョン22以前を使用しています。このSDKは更新を受け取っていないため、新しいの最新バージョンにアップグレードすることをお勧めします。

パーシャルビューは、別のビューのレンダリングされた出力内にHTML出力をレンダリングします。partial viewという用語は、マークアップファイルをviewsと呼ぶASP.NET Model-View-Controller (MVC) アプリ、またはマークアップファイルをpagesと呼ぶRazor Pagesアプリを開発するときに使用します。詳細については、部分ビューに関するMicrosoftのドキュメントを参照してください。

SitecoreレンダリングエンジンSDKは、Sitecoreページを構成する軽量コンポーネントにMVCパーシャルビューを使用します。たとえば、プレースホルダーのみを含む構造コンポーネントなどです。

Sitecoreレンダリングホストアプリケーションでのパーシャルビューの作成は、標準のMVC規則に従います。同様に、Sitecoreレンダリングホストでのパーシャルビューの検出は、ASP.NET Core MVCの標準ルールに従います。

レイアウトサービスの応答を部分ビューにマップする必要があります。これらのマッピングは、StartupクラスのConfigureServices() メソッドで構成されます。

パーシャルビューの構成

パーシャルビューを作成したら、AddPartialView<TModel>() およびAddDefaultPartialView() 拡張メソッドを使用して、Layout Serviceの応答をパーシャルビューにマッピングする必要があります。

この例では、AddPartialView("HeaderBlock", "_HeaderBlock")HeaderBlockレスポンスコンポーネントを_HeaderBlockパーシャルビューにマップし、AddPartialView(name => name.StartsWith("sc"), "_OtherBlock") scが付いたすべてのレスポンスコンポーネントのプレフィックスを _OtherBlockパーシャルビューにマップし、AddDefaultPartialView("_ComponentNotFound") 前の2つのメソッド呼び出しで一致しなかったレスポンスコンポーネントを _ComponentNotFoundのデフォルトのパーシャルビューにマップします。

public void ConfigureServices(IServiceCollection services)
{
  var renderingEngineBuilder = services.AddSitecoreRenderingEngine(options =>
    options

      // Map Partials
      .AddPartialView("HeaderBlock", "_HeaderBlock")
      .AddPartialView(name => name.StartsWith("sc"), "_OtherBlock")

      // Add fallback for any other component
      .AddDefaultPartialView("_ComponentNotFound");
  );
}

パーシャルビュー RazorビューからSitecoreコンテンツにアクセスする

Razorビューにコードブロックを追加して、レイアウトサービスデータにアクセスできます。

@using MyRenderingHost.ViewModels;
@using Sitecore.LayoutService.Client.Response.Model.Fields
@{
var route = this.SitecoreRoute();
var context = this.SitecoreContext();
var component = this.SitecoreComponent().ReadFields<ContentBlock>();
var pageTitleField = route.ReadField<TextField>("pageTitle");
}
<section>
<h1 asp-for="@pageTitleField"></h1>
<h2>Site name: @context.Site.Name</h1>
<h2>Route name: @route.Name</h1>
<h2 asp-for="@component.Heading"></h2>
<div>
<sc-text asp-for="@component.Content"></sc-text>
</div>
</section>

ここでは、レイアウトサービスの結果からコンテンツを読み取ることができますが、モデルバインドを使用して値を読み取ることはできません。パーシャルビューでルート、コンテキスト、またはコンポーネントの値にアクセスする必要がある場合は、代わりにモデルバウンドビューまたはビューコンポーネントの使用を検討してください。

パーシャルビューからビューコンポーネントへの移行

部分ビューでは、レイアウトサービスの応答からのデータへのアクセスが必要な場合があります。これは、パーシャルビューが意図したよりも複雑になっていることを示している可能性があります。この場合は、代わりにモデルバインドビューコンポーネントを使用することをお勧めします。

幸い、パーシャルビューからモデルバインドビューコンポーネントへの移行は非常に簡単です。

必要なレイアウトサービスの応答プロパティを持つビューモデルを作成します。
Startupクラスでは、パーシャルビューの登録をモデルバインドビューコンポーネントの登録に置き換えます。
Razorビューが/Views/Shared/Components/SitecoreComponentフォルダーに配置されていることを確認します。

この記事を改善するための提案がある場合は、お知らせください!