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 値と比較するかどうかを決定するブール値。

その他のリソース