Вспомогательная функция тега сценария в 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.

Дополнительные ресурсы