タグヘルパー

Version:

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

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

!重要以前にアプリを統合していた場合、それは旧版のASP.NETコアレンダリングSDK(バージョン22以前)を使用しています。このSDKは更新を受け取っていないため、最新のバージョンへのアップグレードをお勧めします。

ASP.NETでは、タグヘルパーがサーバーサイドのコードがRazorファイル内のHTML要素の作成およびレンダリングに参加できるようにします。タグヘルパーに関する詳細はMicrosoftタグヘルパーのドキュメントでご覧いただけます。

Sitecore ASP.NETレンダリングSDKは、コンテンツのレンダリング、プレースホルダーデータ、ページ編集に必要なメタデータをレンダリングするための複数のカスタムタグヘルパーを提供します。

以下のタグヘルパーはSitecore.AspNet.RenderingEngineライブラリで利用可能です:

!注要素内容を作成または修正するASP.NETタグヘルパーでは、明示的なクロージングタグを使用しなければなりません。タグが自己閉じている場合、タグヘルパーが要素コンテンツ(この場合はフィールド値)を挿入する場所はありません。

Sitecoreタグヘルパーがレンダリングホストアプリケーションで利用可能であることを保証するには、\Views\_ViewImports.cshtmlRazorビューでタグヘルパーを含むライブラリの名前空間をインポートする必要があります:

@addTagHelper *, Sitecore.AspNet.RenderingEngine

プレースホルダータグヘルパー

プレースホルダータグヘルパーは、Sitecoreのプレースホルダーで定義されたコンポーネントをレンダリングできます。デフォルトでは、タグヘルパーは複数のネストされたプレースホルダーのレンダリングもサポートしています。

ページが編集モードにあるとき、タグヘルパーはコンポーネントに加えて編集用のクロームもレンダリングします。

このタグヘルパーを使うには、単独タグとして追加します:

name属性が必要であり、その値は現在のコンポーネントに対してレイアウトサービスから返されるプレースホルダーの名前と一致しなければなりません。nameが無効またはマッチしていない場合、タグヘルパーはHTMLコメントを使ってページ上に警告を表示します。

!注プレースホルダータグヘルパーは、レイアウトサービスの出力に基づいてコンポーネントをレンダリングするエントリーポイントです。通常、UseSitecoreRenderingでタグ付けされたコントローラーアクションで返されるビュー内に、このタグヘルパーのインスタンスが1つ以上見つかります。

テキストフィールドタグヘルパーは、ページが編集モードにあるときに、単行および多行テキストフィールドの内容をレンダリング・編集できます。

このタグヘルパーを使うには、HTML要素のasp-for属性にTextFieldプロパティの名前を追加します:

@model MyComponentModel

HTML Breakタグへの改行文字の翻訳を無効にするには、convert-new-lines属性を追加し、false:

@model MyComponentModel

テキストフィールドの編集を無効にするには、editable属性(デフォルトでtrue)を追加します:

@model MyComponentModel

リッチテキストフィールドタグヘルパーは、ページが編集モードにあるときにSitecoreのリッチテキストフィールドの内容をレンダリング・編集できます。

このタグヘルパーは2つの方法で使えます:

リッチテキストフィールドの編集を無効にするには、editable属性(デフォルトでtrue)を追加してください:

@model MyComponentModel

ハイパーリンクタグヘルパーは、ページが編集モードにある際にSitecoreの一般的なリンクフィールドの内容をレンダリング・編集できます。

このタグヘルパーは2つの方法で使えます:

単独タグとして追加してください:

@model MyComponent

!注コンテンツ作成者にリンクテキストの設定をさせたくない場合は、静的リンクテキストを追加できます:

@model MyComponentこれは私の カスタム テキストです
そのa HTML要素のasp-for属性にHyperLinkFieldプロパティ名を追加します:

@model MyComponentModel It is my link!