Pomocná rutina značek skriptů v ASP.NET Core

  • Článek

Autor: Rick Anderson

Pomocná rutina značky skriptu vygeneruje odkaz na primární nebo záložní soubor skriptu. Primární soubor skriptu je obvykle ve službě Content Delivery Network (CDN).

SÍŤ CDN:

  • Poskytuje několik výhod výkonu a hostování prostředku s webovou aplikací.
  • Neměli byste se spoléhat jako na jediný zdroj prostředku. Sítě CDN nejsou vždy dostupné, proto by se měla použít spolehlivá záložní služba. Náhradním webem, který je hostitelem webové aplikace, je obvykle záložní web.

Pomocná rutina značek skriptů umožňuje zadat síť CDN pro soubor skriptu a náhradní, pokud síť CDN není k dispozici. Pomocná rutina značky skriptu poskytuje výhodu výkonu sítě CDN s odolností místního hostování.

Následující Razor kód ukazuje script prvek s náhradním kódem:

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

Nepoužívejte atribut odložení elementu <script> k odložení načítání skriptu CDN. Pomocník značky skriptu vykreslí JavaScript, který okamžitě spustí výraz asp-fallback-test . Výraz selže, pokud je odloženo načtení skriptu CDN.

Běžně používané atributy pomocné rutiny značek skriptů

Viz Pomocné rutiny značky skriptu pro všechny atributy, vlastnosti a metody pomocné rutiny značky skriptu.

src

Adresa externího skriptu, který se má použít.

asp-append-version

Pokud asp-append-version je zadána hodnota spolu s true atributem src , vygeneruje se jedinečná verze.

Pomocná rutina značek, která vygeneruje verzi statického souboru mimo wwwroot, najdete v tématu Obsluha souborů z více umístění.

asp-fallback-src

Adresa URL značky Script, která se má v případě selhání primární značky vrátit.

asp-fallback-src-exclude

Čárkami oddělený seznam vzorů souborů globbed skriptů JavaScriptu, které se mají vyloučit z záložního seznamu, v případě selhání primárního skriptu. Vzory globu se posuzují vzhledem k nastavení aplikace webroot . Musí být použita ve spojení s asp-fallback-src-include.

asp-fallback-src-include

Čárkami oddělený seznam vzorů souborů globbed skriptů JavaScriptu, na které se v případě selhání primárního skriptu přepojí. Vzory globu se posuzují vzhledem k nastavení aplikace webroot .

asp-fallback-test

Metoda skriptu definovaná v primárním skriptu, která se má použít pro záložní test. Další informace najdete na webu FallbackTestExpression.

asp-order

Při spuštění sady ITagHelper instancí jsou jejich Init(TagHelperContext) metody nejprve vyvolány v zadaném pořadí; jejich ProcessAsync(TagHelperContext, TagHelperOutput) metody jsou vyvolány v zadaném pořadí. Nejprve se spustí nižší hodnoty.

asp-src-exclude

Čárkami oddělený seznam vzorů souborů globbed javascriptových skriptů, které se mají vyloučit z načítání. Vzory globu se posuzují vzhledem k nastavení aplikace webroot . Musí být použita ve spojení s asp-src-include.

asp-src-include

Čárkami oddělený seznam vzorů souborů globbed skriptů JavaScriptu, které se mají načíst. Vzory globu se posuzují vzhledem k nastavení aplikace webroot .

asp-suppress-fallback-integrity

Logická hodnota, která určuje, jestli se hodnota hash integrity porovná s hodnotou asp-fallback-src.

Další prostředky