ASP.NET Core 中的脚本标记帮助程序
标记帮助程序用于生成指向主要或回退脚本文件的链接。 通常主脚本文件位于内容分发网络 (CDN)。
CDN:
- 提供多个性能优势,并使用 Web 应用托管资产。
- 不应依赖作为资产的唯一来源。 CDN 并非始终可用,因此应使用可靠的回退。 通常,回退是托管 Web 应用的站点。
可以使用脚本标记帮助程序指定脚本文件的 CDN 以及回退文件(CDN 不可用时)。 脚本标记帮助程序借助本地宿主的可靠性提供 CDN 性能优势。
以下 Razor 标记显示使用 ASP.NET Core Web 应用模板创建的布局文件的 script
元素:
HTML
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"
asp-fallback-src="~/lib/jquery/dist/jquery.min.js"
asp-fallback-test="window.jQuery"
crossorigin="anonymous"
integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=">
</script>
以下内容类似于上述代码呈现的 HTML(非开发环境):
C#
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"
crossorigin="anonymous"
integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8=">
</script>
<script> (window.jQuery || document.write(
"\u003Cscript src=\u0022\/lib\/jquery\/dist\/jquery.min.js\u0022 " +
"crossorigin =\u0022anonymous\u0022 integrity =\u0022sha256 - " +
"FgpCb\/KJQ32o\/NM<snip>u8=\u0022\u003E\u003C\/script\u003E"));
</script>
在上述代码中,脚本标记帮助程序生成了第二个脚本 (<script> (window.jQuery || document.write(
) 元素,该元素测试 window.jQuery
。 如果找不到 window.jQuery
,document.write(
将运行并创建脚本
常用的脚本标记帮助程序属性
若要了解所有脚本标记帮助程序属性和方法,请参阅标记帮助程序。
href
链接的资源的首选地址。 在任何情况下,均会将此地址传递到生成的 HTML。
asp-fallback-href
主 URL 失效后要回退到的 CSS 样式表的 URL。
asp-fallback-test-class
样式表中定义的用于回退测试的类名称。 有关详细信息,请参阅 FallbackTestClass。
asp-fallback-test-property
用于回退测试的 CSS 属性名称。 有关详细信息,请参阅 FallbackTestProperty。
asp-fallback-test-value
用于回退测试的 CSS 属性值。 有关详细信息,请参阅 FallbackTestValue。
asp-fallback-test-value
用于回退测试的 CSS 属性值。 有关详细信息,请参阅FallbackTestValue。