ASP.NET Core 中的脚本标记帮助程序Script Tag Helper in ASP.NET Core

本文内容

作者:Rick Anderson

标记帮助程序用于生成指向主要或回退脚本文件的链接。通常主脚本文件位于内容分发网络 (CDN)。

CDN:

  • 提供多个性能优势,并使用 Web 应用托管资产。
  • 不应依赖作为资产的唯一来源。CDN 并非始终可用,因此应使用可靠的回退。通常,回退是托管 Web 应用的站点。

可以使用脚本标记帮助程序指定脚本文件的 CDN 以及回退文件(CDN 不可用时)。脚本标记帮助程序借助本地宿主的可靠性提供 CDN 性能优势。

以下 Razor 标记显示了带有一个回退操作的 script 元素:

  1. <script src="https://ajax.aspnetcdn.com/ajax/jquery/jquery-3.3.1.min.js"
  2. asp-fallback-src="~/lib/jquery/dist/jquery.min.js"
  3. asp-fallback-test="window.jQuery"
  4. crossorigin="anonymous"
  5. integrity="sha384-tsQFqpEReu7ZLhBV2VZlAu7zcOV+rXbYlF2cqB8txI/8aZajjp4Bqd+V6D5IgvKT">
  6. </script>

请勿使用 <script> 元素的 defer 属性来延迟加载 CDN 脚本。脚本标记帮助程序呈现能够立即执行 asp-fallback-test 表达式的 JavaScript。如果延迟加载 CDN 脚本,则该表达式失败。

常用的脚本标记帮助程序属性Commonly used Script Tag Helper attributes

若要了解所有脚本标记帮助程序属性和方法,请参阅标记帮助程序

asp-fallback-testasp-fallback-test

主脚本中定义的用于回退测试的脚本方法。有关详细信息,请参阅 FallbackTestExpression

asp-fallback-srcasp-fallback-src

主 URL 失效后要回退到的脚本标签的 URL。有关详细信息,请参阅 FallbackSrc

其他资源Additional resources