Pomocnik tagów skryptów w programie ASP.NET Core

  • Artykuł

Autor: Rick Anderson

Pomocnik tagu skryptu generuje link do podstawowego lub powrotnego pliku skryptu. Zazwyczaj podstawowy plik skryptu znajduje się w usłudze Content Delivery Network (CDN).

Sieć CDN:

  • Zapewnia kilka zalet wydajności a hostowanie zasobu za pomocą aplikacji internetowej.
  • Nie należy polegać na tym, że jest jedynym źródłem zasobu. Sieci CDN nie zawsze są dostępne, dlatego należy użyć niezawodnego rezerwowego. Zazwyczaj rezerwowa to witryna hostująca aplikację internetową.

Pomocnik tagów skryptu umożliwia określenie sieci CDN dla pliku skryptu i rezerwowego, gdy sieć CDN jest niedostępna. Pomocnik tagów skryptów zapewnia zaletę wydajności sieci CDN z niezawodnością hostingu lokalnego.

Razor Poniższy znacznik przedstawia script element z rezerwowym elementem:

<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>

Nie używaj atrybutu <script>odroczenia elementu, aby odroczyć ładowanie skryptu usługi CDN. Pomocnik tagu skryptu renderuje język JavaScript, który natychmiast wykonuje wyrażenie asp-fallback-test . Wyrażenie kończy się niepowodzeniem, jeśli ładowanie skryptu usługi CDN zostanie odroczone.

Często używane atrybuty pomocnika tagów skryptu

Zobacz Pomocnik tagów skryptów dla wszystkich atrybutów, właściwości i metod pomocnika tagów skryptu.

src

Adres zewnętrznego skryptu do użycia.

asp-append-version

Po asp-append-version określeniu true wartości wraz z atrybutem src jest generowana unikatowa wersja.

Aby pomocnik tagów wygenerował wersję pliku statycznego poza wwwrootprogramem , zobacz Obsługa plików z wielu lokalizacji

asp-fallback-src

Adres URL tagu skryptu do powrotu do adresu w przypadku niepowodzenia podstawowego.

asp-fallback-src-exclude

Rozdzielona przecinkami lista wzorców plików globbed skryptów Języka JavaScript do wykluczenia z listy rezerwowej w przypadku awarii podstawowej. Wzorce glob są oceniane względem ustawienia aplikacji webroot . Należy używać w połączeniu z asp-fallback-src-include.

asp-fallback-src-include

Rozdzielona przecinkami lista wzorców plików globbed skryptów Języka JavaScript do powrotu w przypadku awarii podstawowej. Wzorce glob są oceniane względem ustawienia aplikacji webroot .

asp-fallback-test

Metoda skryptu zdefiniowana w skrypacie podstawowym do użycia na potrzeby testu rezerwowego. W celu uzyskania więcej informacji, zobacz następujący temat: FallbackTestExpression.

asp-order

Po wykonaniu ITagHelper zestawu wystąpień metody Init(TagHelperContext) są najpierw wywoływane w określonej kolejności, a następnie ich ProcessAsync(TagHelperContext, TagHelperOutput) metody są wywoływane w określonej kolejności. Najpierw są wykonywane niższe wartości.

asp-src-exclude

Rozdzielona przecinkami lista wzorców plików globbed skryptów JavaScript do wykluczenia z ładowania. Wzorce glob są oceniane względem ustawienia aplikacji webroot . Należy używać w połączeniu z asp-src-include.

asp-src-include

Rozdzielona przecinkami lista wzorców plików globbed skryptów JavaScript do załadowania. Wzorce glob są oceniane względem ustawienia aplikacji webroot .

asp-suppress-fallback-integrity

Wartość logiczna określająca, czy skrót integralności zostanie porównany z wartością asp-fallback-src.

Dodatkowe zasoby