Script Tag Helper in ASP.NET Core
The Script Tag Helper generates a link to a primary or fall back script file. Typically the primary script file is on a Content Delivery Network (CDN).
A CDN:
- Provides several performance advantages vs hosting the asset with the web app.
- Should not be relied on as the only source for the asset. CDNs are not always available, therefore a reliable fallback should be used. Typically the fallback is the site hosting the web app.
The Script Tag Helper allows you to specify a CDN for the script file and a fallback when the CDN is not available. The Script Tag Helper provides the performance advantage of a CDN with the robustness of local hosting.
The following Razor markup shows a script
element with a fallback:
<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>
Don't use the <script>
element's defer attribute to defer loading the CDN script. The Script Tag Helper renders JavaScript that immediately executes the asp-fallback-test expression. The expression fails if loading the CDN script is deferred.
Commonly used Script Tag Helper attributes
See Script Tag Helper for all the Script Tag Helper attributes, properties, and methods.
src
Address of the external script to use.
asp-append-version
When asp-append-version
is specified with a true
value along with a src
attribute, a unique version is generated.
For a Tag Helper to generate a version for a static file outside wwwroot
, see Serve files from multiple locations
asp-fallback-src
The URL of a Script tag to fallback to in the case the primary one fails.
asp-fallback-src-exclude
A comma-separated list of globbed file patterns of JavaScript scripts to exclude from the fallback list, in the case the primary one fails. The glob patterns are assessed relative to the application's webroot
setting. Must be used in conjunction with asp-fallback-src-include
.
asp-fallback-src-include
A comma-separated list of globbed file patterns of JavaScript scripts to fallback to in the case the primary one fails. The glob patterns are assessed relative to the application's webroot
setting.
asp-fallback-test
The script method defined in the primary script to use for the fallback test. For more information, see FallbackTestExpression.
asp-order
When a set of ITagHelper
instances are executed, their Init(TagHelperContext)
methods are first invoked in the specified order; then their ProcessAsync(TagHelperContext, TagHelperOutput)
methods are invoked in the specified order. Lower values are executed first.
asp-src-exclude
A comma-separated list of globbed file patterns of JavaScript scripts to exclude from loading. The glob patterns are assessed relative to the application's webroot
setting. Must be used in conjunction with asp-src-include
.
asp-src-include
A comma-separated list of globbed file patterns of JavaScript scripts to load. The glob patterns are assessed relative to the application's webroot
setting.
asp-suppress-fallback-integrity
Boolean value that determines if an integrity hash will be compared with the asp-fallback-src value.
Additional resources
ASP.NET Core
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho