Asistente de etiquetas de script en ASP.NET Core
Por Rick Anderson
El asistente de etiquetas de script genera un vínculo a un archivo de script principal o de reserva. Normalmente, el archivo de script principal se encuentra en una red Content Delivery Network (CDN).
Una CDN:
- Proporciona varias ventajas de rendimiento frente al hospedaje del recurso con la aplicación web.
- No se debe confiar en ella como el único origen para el recurso. Las redes CDN no siempre están disponibles, por lo que se debe usar una reserva confiable. Normalmente, la reserva es el sitio que hospeda la aplicación web.
El asistente de etiquetas de script permite especificar una red CDN para el archivo de script y una reserva cuando dicha red no está disponible. El asistente de etiquetas de script proporciona la ventaja de rendimiento de una red CDN con la solidez del hospedaje local.
En el marcado de Razor siguiente se muestra un elemento script
con una reserva:
<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>
No use el atributo defer del elemento <script>
para diferir la carga del script de CDN. El Asistente de etiquetas de script representa JavaScript que ejecuta de inmediato la expresión asp-fallback-test. Se produce un error en la expresión si se difiere la carga del script de CDN.
Atributos del asistente de etiquetas de script utilizados habitualmente
Consulte Asistente de etiquetas de script para todos los atributos, propiedades y métodos del asistente de etiquetas de script.
src
Dirección del script externo que se va a usar.
asp-append-version
Cuando asp-append-version
se especifica con un valor true
junto con un atributo src
, se genera una versión única.
Para que un asistente de etiquetas genere una versión para un archivo estático fuera de wwwroot
, consulte Servir archivos desde varias ubicaciones
asp-fallback-src
Dirección URL de una etiqueta de script en la que se va a realizar la reserva en caso de error en principal.
asp-fallback-src-exclude
Lista separada por comas de patrones de archivo globales de scripts de JavaScript para excluir de la lista de reserva, en caso de que se produzca un error en el archivo principal. Los patrones globales se evalúan en relación con la configuración webroot
de la aplicación. No se puede usar con asp-fallback-src-include
.
asp-fallback-src-include
Una lista separada por comas de patrones de archivo globales de scripts de JavaScript a usar en caso de que se produzca un error en el archivo principal. Los patrones globales se evalúan en relación con la configuración webroot
de la aplicación.
asp-fallback-test
Método de script definido en el script principal que se va a usar para la prueba de reserva. Para obtener más información, vea FallbackTestExpression.
asp-order
Cuando se ejecuta un conjunto de instancias ITagHelper
, sus métodos Init(TagHelperContext)
se invocan primero en el orden especificado; a continuación, sus métodos ProcessAsync(TagHelperContext, TagHelperOutput)
se invocan en el orden especificado. Los valores más bajos se ejecutan primero.
asp-src-exclude
Lista separada por comas de patrones de archivo globales de scripts de JavaScript que se van a excluir de la carga. Los patrones globales se evalúan en relación con la configuración webroot
de la aplicación. No se puede usar con asp-src-include
.
asp-src-include
Lista separada por comas de patrones de archivo globales de scripts de JavaScript que se van a cargar. Los patrones globales se evalúan en relación con la configuración webroot
de la aplicación.
asp-suppress-fallback-integrity
Valor booleano que determina si se comparará un hash de integridad con el valor asp-fallback-src.
Recursos adicionales
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de