次の方法で共有

ASP.NET Core のスクリプト タグ ヘルパー

作成者: Rick Anderson

スクリプト タグ ヘルパーは、プライマリ スクリプト ファイルまたはフォールバック スクリプト ファイルへのリンクを生成します。 通常、プライマリ スクリプト ファイルは Content Delivery Network (CDN) 上にあります。

CDN:

  • Web アプリ を使用して資産を ホストする場合と比較して、パフォーマンス上のいくつかの利点が提供されます。
  • 資産の唯一のソースとして依存しないでください。 CDN は常に使用できるとは限らないため、信頼性の高いフォールバックを使用する必要があります。 通常、フォールバックは 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>

<script>要素の defer 属性を使用して CDN スクリプトの読み込みを延期しないでください。 スクリプト タグ ヘルパーは、 asp-fallback-test 式をすぐに実行する JavaScript をレンダリングします。 CDN スクリプトの読み込みが延期されると、式は失敗します。

一般的に使用されるスクリプト タグ ヘルパー属性

スクリプト タグ ヘルパー のすべての属性、プロパティ、およびメソッドについては、「スクリプト タグ ヘルパー」を参照してください。

src

使用する外部スクリプトのアドレス。

asp-append-version

asp-append-version true値とsrc属性を指定すると、一意のバージョンが生成されます。

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

その他のリソース

  • Last updated on