Script Tag Helper dans ASP.NET Core

  • Article

Par Rick Anderson

Le Tag Helper du script génère un lien vers un fichier de script principal ou de secours. En règle générale, le fichier de script principal se trouve sur un réseau de distribution contenu (CDN).

Un CDN :

  • Offre plusieurs avantages en matière de performances par rapport à l’hébergement de la ressource avec l’application web.
  • Ne doit pas être considéré comme la seule source de la ressource. Les CDN ne sont pas toujours disponibles. Par conséquent, un secours fiable doit être utilisé. En règle générale, le site hébergeant l’application web est le site de secours.

Le Tag Helper du script vous permet de spécifier un CDN pour le fichier de script et un secours en cas d’indisponibilité du CDN. Le Tag Helper du script offre l’avantage en matière de performances d’un CDN avec la robustesse d’un hébergement local.

Le balisage Razor suivant montre un élément script avec un élément de secours :

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

N’utilisez pas l’attribut defer de l’élément <script> pour différer le chargement du script CDN. Le Tag Helper du script affiche un JavaScript exécutant immédiatement l’expression asp-fallback-test. L’expression échoue si le chargement du script CDN est retardé.

Attributs du script Tag Helper couramment utilisés

Consultez Tag Helper du script pour tous les attributs, propriétés et méthodes du Tag Helper du script.

src

Adresse du script externe à utiliser.

asp-append-version

Quand asp-append-version est spécifié avec une valeur true, ainsi qu’un attribut src, une version unique est générée.

Afin qu’un Tag Helper génère une version pour un fichier statique en dehors de wwwroot, consultez Délivrer des fichiers à partir de plusieurs emplacements

asp-fallback-src

URL d’une balise du script vers laquelle revenir en cas d’échec de la balise principale du script.

asp-fallback-src-exclude

Liste des modèles de fichiers groupés de scripts JavaScript (séparés par des virgules) à exclure de la liste de secours, en cas d’échec du fichier principal. Les modèles Glob sont évalués par rapport au paramètre webroot de l’application. Cette option doit être utilisée en conjonction avec asp-fallback-src-include.

asp-fallback-src-include

Liste des modèles de fichiers groupés de scripts JavaScript (séparés par des virgules) à utiliser en cas d’échec du fichier principal. Les modèles Glob sont évalués par rapport au paramètre webroot de l’application.

asp-fallback-test

Méthode de script définie dans le script principal à utiliser pour le test du secours. Pour plus d’informations, consultez FallbackTestExpression.

asp-order

Lorsqu’un ensemble d’instances ITagHelper est exécuté, leurs méthodes Init(TagHelperContext) sont d’abord appelées dans l’ordre spécifié, idem pour leurs méthodes ProcessAsync(TagHelperContext, TagHelperOutput) par la suite. Les plus petites valeurs sont exécutées en premier.

asp-src-exclude

Liste des modèles de fichiers groupés de scripts JavaScript (séparés par des virgules) à exclure du chargement. Les modèles Glob sont évalués par rapport au paramètre webroot de l’application. Cette option doit être utilisée en conjonction avec asp-src-include.

asp-src-include

Liste des modèles de fichiers groupés de scripts JavaScript (séparés par des virgules) à charger. Les modèles Glob sont évalués par rapport au paramètre webroot de l’application.

asp-suppress-fallback-integrity

Valeur booléenne qui détermine si un hachage d’intégrité va être comparé à la valeur asp-fallback-src.

Ressources supplémentaires