Asistente de etiquetas de script en ASP.NET Core

  • Artículo

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