注記
これは、この記事の最新バージョンではありません。 現在のリリースについては、この記事の .NET 11 バージョンを参照してください。
この記事では、静的サーバー側レンダリング (静的 SSR) のサポートを検討しているコンポーネント ライブラリ作成者のためのガイダンスを提供します。
Blazor は、正式には Razor クラス ライブラリ (RCL) と呼ばれる、オープンソースおよび商用のコンポーネント ライブラリのエコシステムの開発を促進します。 開発者は、自社内のアプリ間でコンポーネントを非公開で共有するための再利用可能なコンポーネントを作成することもできます。 コンポーネントは、理想的には、可能な限り多くのホスティング モデルおよびレンダリング モードと互換性があるように開発します。 静的 SSR では、対話型レンダリング モードよりサポートが難しい追加の制限が導入されます。
静的 SSR の機能と制限について理解する
Static SSR は、サーバーが着信した HTTP 要求を処理するときにコンポーネントが実行されるモードです。 Blazor は、応答に含まれる HTML としてコンポーネントをレンダリングします。 応答が送信されると、サーバー側のコンポーネントとレンダラーの状態は破棄されるため、残っているのはブラウザーの HTML だけです。
このモードの長所は、コンポーネントの状態を保持するために継続的なサーバー リソースが必要なく、ブラウザーとサーバーの間で継続的な接続を維持する必要がなく、ブラウザーで WebAssembly ペイロードが必要ないため、安価でスケーラブルなホスティングであることです。
既存のすべてのコンポーネントを静的 SSR で引き続き使用できます。 ただし、このモードを使用すると、次の理由により、@onclick† などのイベント ハンドラーを実行できなくなります。
- それらを実行するための .NET コードがブラウザーにありません。
- サーバーは、イベント ハンドラーの実行または同じコンポーネント インスタンスの再レンダリングに必要なコンポーネントとレンダラーの状態を、即座に破棄します。
†フォーム用の @onsubmit イベント ハンドラーには特別な例外があり、レンダリング モードに関係なく、常に機能します。
これは、Blazor の SignalR 回路や .NET WebAssembly ランタイムが起動される前の、プリレンダリング中のコンポーネントの動作と同じです。
読み取り専用の DOM コンテンツを生成することが唯一の役割であるコンポーネントの場合は、静的 SSR のこのような動作でもまったく問題ありません。 一方、ライブラリに対話型コンポーネントを含める場合は、ライブラリ作成者はどのようなアプローチにするか検討する必要があります。
コンポーネント作成者のためのオプション
主に 3 つの方法があります。
インタラクティブな動作を使用しない (基本)
読み取り専用 DOM コンテンツの生成が唯一の役割のコンポーネントの場合、開発者は特別なアクションを行う必要はありません。 これらのコンポーネントは、どのレンダリング モードでも自然に動作します。
例:
- 人物に対応するデータを読み込み、写真、役職、その他の詳細を含むスタイル化された UI にそれをレンダリングする "ユーザー カード" コンポーネント。
- HTML の
<video>要素を Razor コンポーネントでより使いやすくするためのラッパーとして機能する "ビデオ" コンポーネント。
インタラクティブ レンダリングを必須にする(基本)
コンポーネントが対話型レンダリングのみで使われることを必須にできます。 このようにすると、コンポーネントの適用性は制限されますが、任意のイベント ハンドラーに自由に依存できることを意味します。 その場合でも、特定の
@rendermodeを宣言することは避け、ライブラリを使うアプリ作成者が選択できるようにする必要があります。例:
- ユーザーがビデオのセグメントをスプライスして順序を変更できるビデオ編集コンポーネント。 これらの編集操作をプレーンな HTML ボタンとフォームの投稿で表す方法があったとしても、真の対話機能がなければ、ユーザー エクスペリエンスは受け入れられません。
- 他のユーザーのアクティビティをリアルタイムで表示する必要がある共同作業ドキュメント エディター。
対話型の動作を使用するが、静的SSRとプログレッシブエンハンスメントを前提に設計する (高度)
多くの対話型動作は、HTML の機能だけを使って実装できます。 HTML と CSS についてよく理解していれば、静的 SSR で動作する機能の有用なベースラインを生成できることがよくあります。 さらに高度なオプションの動作を実装するイベント ハンドラーを宣言することもできます。これは、対話型レンダリング モードでのみ機能します。
例:
- グリッド コンポーネント。 静的 SSR では、コンポーネントはデータの表示とページ間の移動 (
<a>リンクを使用して実装) のみをサポートできます。 対話型レンダリングでコンポーネントを使うと、ライブの並べ替えとフィルター処理が追加される場合があります。 - タブセット コンポーネント。 タブ間のナビゲーションが
<a>リンクを使って実現されていて、状態が URL クエリ パラメーターのみで保持されている限り、コンポーネントは@onclickなしで機能できます。 - 高度なファイル アップロード コンポーネント。 静的 SSR では、コンポーネントはネイティブ
<input type=file>として動作する場合があります。 対話型レンダリングでコンポーネントを使うと、アップロードの進行状況を表示することもできます。 - 株価表示。 静的 SSR でのコンポーネントは、HTML がレンダリングされた時点での株価情報を表示できます。 対話型レンダリングでコンポーネントを使うと、株価をリアルタイムで更新できます。
- グリッド コンポーネント。 静的 SSR では、コンポーネントはデータの表示とページ間の移動 (
これらのどの戦略でも、JavaScript を使って対話型機能を実装することもできます。
再利用可能な Razor コンポーネントの作成者は、これらのアプローチから選ぶには、コストと便益のトレードオフを行う必要があります。 静的 SSR を含むすべてのレンダリング モードをサポートしていれば、コンポーネントはより便利になり、潜在的なユーザー層も広がります。 ただし、各レンダリング モードをサポートし、最大限に活用するコンポーネントを設計および実装するには、より多くの作業が必要になります。
@rendermode ディレクティブを使うべきとき
ほとんどの場合、再利用可能なコンポーネントの作成者は、対話機能が必要な場合であっても、レンダリング モードを指定しないようにする必要があります。 これは、アプリで InteractiveServer、InteractiveWebAssembly、またはその両方 (InteractiveAuto) のサポートが有効になっているかどうかが、コンポーネントの作成者にはわからないためです。 コンポーネントの作成者は、@rendermode を指定しないことで、選択をアプリの開発者に委ねることができます。
対話機能が必要であるとコンポーネント作成者が考える場合でも、静的 SSR を使うだけで十分であるとアプリ作成者が考えるケースもあり得ます。 たとえば、ドラッグとズームの対話機能を持つマップ コンポーネントでは、対話機能が必要と思われるかもしれません。 しかし、シナリオによっては、静的マップ イメージのレンダリングを呼び出すだけでよく、ドラッグとズーム機能は使わなくて済む場合があります。
再利用可能なコンポーネントの作成者がコンポーネントで @rendermode ディレクティブをどうしても使わなければならない唯一の理由は、実装が基本的に 1 つの特定のレンダリング モードに結び付けられていて、別のモードで使うと確実にエラーが発生する場合です。 Windows または Linux 固有の API を使ってホスト OS と直接対話することが主な目的であるコンポーネントについて考えてみてください。 WebAssembly でこのようなコンポーネントを使うのは不可能な場合があります。 その場合は、コンポーネントに対して @rendermode InteractiveServer を宣言する十分な理由になります。
ストリーミング レンダリング
再利用可能な Razor コンポーネントでは、@attribute [StreamRendering] を ストリーミングレンダリング 用に自由に宣言できます ([StreamRendering] 属性 API)。 これにより、静的 SSR の間に UI の増分更新が行われます。 同じデータ読み込みパターンによって、[StreamRendering] 属性の有無に関係なく、対話型レンダリングの間に増分 UI 更新が生成されるため、コンポーネントはすべてのケースで正しく動作できます。 静的 SSR のストリーミングがサーバーで抑制されている場合でも、コンポーネントは正しい最終状態をレンダリングします。
異なるレンダリング モードでのリンクの使用
再利用可能な Razor コンポーネントでは、リンクと拡張ナビゲーションを使用できます。 HTML の <a> タグでは、対話型 Router コンポーネントであってもなくても、また DOM の先祖レベルで拡張ナビゲーションが有効または無効になっているかどうかに関わらず、同じ動作が生成されます。
異なるレンダリング モードでのフォームの使用
再利用可能な Razor コンポーネントにはフォーム (<form> または <EditForm>) を含めることができます。これらは、静的レンダリング モードと対話型レンダリング モードの両方で同等に動作するよう実装できるためです。
次の例を考えてみましょう。
<EditForm Enhance FormName="NewProduct" Model="Model" OnValidSubmit="Save">
<DataAnnotationsValidator />
<ValidationSummary />
<p><label>Name: <InputText @bind-Value="Model!.Name" /></label></p>
<button type="submit">Submit</button>
</EditForm>
@code {
[SupplyParameterFromForm]
private Product? Model { get; set; }
protected override void OnInitialized() => Model ??= new();
private async Task Save()
{
...
}
}
Enhance、FormName、SupplyParameterFromFormAttribute の各 API は静的 SSR の間にのみ使われ、対話型レンダリング中は無視されます。 フォームは、対話型 SSR と静的 SSR のどちらの間も正しく動作します。
静的 SSR に固有の API を回避する
HttpContext は静的 SSR 中にのみ使用できるため、レンダリング モード間で動作するコンポーネントを作成するときは HttpContext に依存しないでください。 対話型レンダリング中は、処理されているアクティブな HTTP 要求はないため、HttpContext API を使っても意味がありません。 HTTP 状態コードの設定や HTTP 応答への書き込みについて考えても無意味です。
次のように、使用可能な場合は再利用可能なコンポーネントで HttpContext を受け取ることができます。
[CascadingParameter]
private HttpContext? Context { get; set; }
対話型レンダリング中は値が null となり、静的 SSR 中にのみ設定されます。
多くの場合、HttpContext を使うより良い選択肢があります。 現在の URL を把握したり、リダイレクトを実行したりする必要がある場合、NavigationManager の API はすべてのレンダリング モードで動作します。 ユーザーの認証状態を知る必要がある場合は、 を使う代わりに、 の サービス( ドキュメント)を使ってください。
ASP.NET Core