Вспомогательная функция тега сценария в ASP.NET Core
Автор: Рик Андерсон (Rick Anderson)
Вспомогательная функция тега сценария создает ссылку на первичный или резервный файл сценария. Обычно первичный файл сценария находится в сети доставки содержимого (CDN).
Сеть CDN:
- Предоставляет несколько улучшений производительности по сравнению с размещением ресурса в веб-приложении.
- Не следует полагаться на эту сеть в качестве единственного источника ресурса. Сети CDN не всегда доступны, поэтому следует использовать надежный резервный вариант. Обычно таким вариантом является сайт, на котором размещается веб-приложение.
Вспомогательная функция тега сценария позволяет указать CDN для файла сценария и резервную копию, если CDN недоступен. Вспомогательная функция тега сценария обеспечивает высокую производительность CDN с надежностью локального размещения.
В следующей Razorscript
разметке показан элемент с резервным вариантом:
<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>
Не используйте атрибут defer элемента <script>
, чтобы отложить загрузку скрипта CDN. Вспомогательная функция тега скрипта обрабатывает код JavaScript, который сразу же выполняет выражение asp-fallback-test. Это выражение дает сбой, если загрузка скрипта CDN отложена.
Часто используемые атрибуты вспомогательной функции тега сценария
Все атрибуты, свойства и методы вспомогательной функции тега сценария см. в статье ScriptTagHelper Class (Класс ScriptTagHelper).
src
Адрес используемого внешнего скрипта.
asp-append-version
При asp-append-version
указании значения вместе с true
атрибутом src
создается уникальная версия.
Вспомогательный компонент тега для создания версии статического файла за пределами wwwroot
см. в разделе "Обслуживание файлов из нескольких расположений"
asp-fallback-src
URL-адрес тега Script, на который можно перейти в случае сбоя основного URL-адреса.
asp-fallback-src-exclude
Список разделенных запятыми шаблонов файлов скриптов JavaScript для исключения из резервного списка в случае сбоя основного файла. Шаблоны глобов оцениваются относительно параметра приложения webroot
. Необходимо использовать в сочетании с asp-fallback-src-include
.
asp-fallback-src-include
Список разделенных запятыми шаблонов файлов скриптов JavaScript для восстановления в случае сбоя основного файла. Шаблоны глобов оцениваются относительно параметра приложения webroot
.
asp-fallback-test
Метод скрипта, определенный в основном скрипте, для использования в тесте резервного экземпляра. Дополнительные сведения см. в разделе FallbackTestExpression.
asp-order
При выполнении набора ITagHelper
экземпляров их Init(TagHelperContext)
методы сначала вызываются в указанном порядке. Затем их ProcessAsync(TagHelperContext, TagHelperOutput)
методы вызываются в указанном порядке. Сначала выполняются более низкие значения.
asp-src-exclude
Список разделенных запятыми шаблонов файлов скриптов JavaScript для исключения из загрузки. Шаблоны глобов оцениваются относительно параметра приложения webroot
. Необходимо использовать в сочетании с asp-src-include
.
asp-src-include
Список разделенных запятыми шаблонов файлов скриптов JavaScript для загрузки. Шаблоны глобов оцениваются относительно параметра приложения webroot
.
asp-suppress-fallback-integrity
Логическое значение, определяющее, будет ли хэш целостности сравниваться со значением asp-fallback-src.
Дополнительные ресурсы
ASP.NET Core
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по