Script Tag Helper in ASP.NET Core

  • Articolo

Di Rick Anderson

L'helper tag script genera un collegamento a un file di script primario o di fallback. In genere il file di script primario si trova in un rete per la distribuzione di contenuti (rete CDN).

Un rete CDN:

  • Offre diversi vantaggi in termini di prestazioni rispetto all'hosting dell'asset con l'app Web.
  • Non deve essere considerato come l'unica origine per l'asset. rete CDN non sono sempre disponibili, pertanto è consigliabile usare un fallback affidabile. In genere il fallback è il sito che ospita l'app Web.

L'helper tag script consente di specificare un rete CDN per il file di script e un fallback quando il rete CDN non è disponibile. L'helper tag script offre il vantaggio delle prestazioni di un rete CDN con l'affidabilità dell'hosting locale.

Il markup seguente Razor mostra un script elemento con un fallback:

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

Non usare l'attributo <script> di rinvio dell'elemento per rinviare il caricamento dello script rete CDN. L'helper tag script esegue il rendering di JavaScript che esegue immediatamente l'espressione asp-fallback-test . L'espressione ha esito negativo se il caricamento dello script di rete CDN viene posticipato.

Attributi helper tag script di uso comune

Vedere Script Tag Helper (Helper tag script) per tutti gli attributi, le proprietà e i metodi dell'helper tag script.

src

Indirizzo dello script esterno da usare.

asp-append-version

Quando asp-append-version viene specificato con un true valore insieme a un src attributo, viene generata una versione univoca.

Per un helper tag per generare una versione per un file statico all'esterno wwwrootdi , vedere Gestire i file da più posizioni

asp-fallback-src

URL di un tag script a cui eseguire il fallback nel caso in cui il tag primario non riesca.

asp-fallback-src-exclude

Un elenco delimitato da virgole di modelli di file globbed di script JavaScript da escludere dall'elenco di fallback, nel caso in cui quello primario non riesca. I modelli GLOB vengono valutati in relazione all'impostazione dell'applicazione webroot . Deve essere usato insieme a asp-fallback-src-include.

asp-fallback-src-include

Un elenco delimitato da virgole di modelli di file globbed di script JavaScript a cui eseguire il fallback nel caso in cui quello primario non riesca. I modelli GLOB vengono valutati in relazione all'impostazione dell'applicazione webroot .

asp-fallback-test

Metodo script definito nello script primario da usare per il test di fallback. Per ulteriori informazioni, vedere FallbackTestExpression.

asp-order

Quando viene eseguito un set di ITagHelper istanze, i relativi Init(TagHelperContext) metodi vengono prima richiamati nell'ordine specificato, quindi i relativi ProcessAsync(TagHelperContext, TagHelperOutput) metodi vengono richiamati nell'ordine specificato. I valori inferiori vengono eseguiti per primi.

asp-src-exclude

Elenco delimitato da virgole di modelli di file globbed degli script JavaScript da escludere dal caricamento. I modelli GLOB vengono valutati in relazione all'impostazione dell'applicazione webroot . Deve essere usato insieme a asp-src-include.

asp-src-include

Elenco delimitato da virgole di modelli di file globbed di script JavaScript da caricare. I modelli GLOB vengono valutati in relazione all'impostazione dell'applicazione webroot .

asp-suppress-fallback-integrity

Valore booleano che determina se un hash di integrità verrà confrontato con il valore asp-fallback-src.

Risorse aggiuntive