ASP.NET Core のスクリプト タグ ヘルパー
作成者: Rick Anderson
スクリプト タグ ヘルパーによって、プライマリまたはフォール バック スクリプト ファイルへのリンクが生成されます。 通常、プライマリ スクリプト ファイルは Content Delivery Network (CDN) 上にあります。
CDN:
- アセットを Web アプリでホストするよりも、いくつかのパフォーマンス上の利点があります。
- アセットのただ 1 つのソースとして依存することはできません。 CDNs は常に使用できるとは限らないため、信頼できるフォールバックを使用する必要があります。 通常、フォールバックは Web アプリをホストしているサイトです。
スクリプト タグ ヘルパーを使用すると、スクリプト ファイルの CDN と、CDN が使用できない場合のフォールバックを指定できます。 スクリプト タグ ヘルパーによって、ローカル ホスティングの堅牢性が CDN のパフォーマンスの利点にもたらされます。
次の Razor マークアップでは、フォールバックを含む script
要素が示されています。
<script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.1.js"
asp-fallback-src="~/lib/jquery/dist/jquery.js"
asp-fallback-test="window.jQuery"
crossorigin="anonymous"
integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT">
</script>
CDN スクリプトの読み込みを延期する場合、<script>
要素の defer 属性を使用しないでください。 スクリプト タグ ヘルパーでは、asp-fallback-test 式を直ちに実行する JavaScript がレンダリングされます。 CDN スクリプトの読み込みが遅延されている場合、式は失敗します。
一般的に使用されるスクリプト タグ ヘルパー属性
スクリプト タグ ヘルパーのすべての属性、プロパティ、メソッドについては、スクリプト タグ ヘルパーに関するページを参照してください。
src
使用する外部スクリプトのアドレス。
asp-append-version
asp-append-version
が src
属性と共に true
値と共に指定されると、一意のバージョンが生成されます。
wwwroot
外部の静的ファイルのバージョンを生成するタグ ヘルパーについては、「複数の場所からファイルを提供する」を参照してください
asp-fallback-src
プライマリ側でエラーが発生した場合にフォールバックするスクリプト タグの URL。
asp-fallback-src-exclude
フォールバック リストから除外する JavaScript スクリプトの globbed ファイル パターンのコンマ区切りのリスト (プライマリファイルが失敗した場合)。 glob パターンは、アプリケーション webroot
の設定に対して評価されます。 asp-fallback-src-include
と組み合わせて使用する必要があります。
asp-fallback-src-include
プライマリ スクリプトが失敗した場合にフォールバックする JavaScript スクリプトの globbed ファイル パターンのコンマ区切りのリスト。 glob パターンは、アプリケーション webroot
の設定に対して評価されます。
asp-fallback-test
フォールバック テストに使用するプライマリ スクリプトで定義されているスクリプト メソッド。 詳細については、FallbackTestExpressionを参照してください。
asp-order
ITagHelper
インスタンス一式が実行されると、その Init(TagHelperContext)
メソッドは最初に指定した順序で呼び出され、その ProcessAsync(TagHelperContext, TagHelperOutput)
メソッドは指定した順序で呼び出されます。 より小さい値がまず実行されます。
asp-src-exclude
読み込みから除外する JavaScript スクリプトの globbed ファイル パターンのコンマ区切りのリスト。 glob パターンは、アプリケーション webroot
の設定に対して評価されます。 asp-src-include
と組み合わせて使用する必要があります。
asp-src-include
読み込む JavaScript スクリプトの globbed ファイル パターンのコンマ区切りのリスト。 glob パターンは、アプリケーション webroot
の設定に対して評価されます。
asp-suppress-fallback-integrity
整合性ハッシュを asp-fallback-src 値と比較するかどうかを決定するブール値。
その他のリソース
ASP.NET Core