Script Tag Helper dans ASP.NET Core
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.