Auxiliar de Marca de Âncora no ASP.NET Core

  • Artigo

De Rick Anderson

O Auxiliar de Marca de Script gera um link para um arquivo CSS primário ou de fallback. Normalmente, o arquivo de script primário está em uma Rede de Distribuição de Conteúdo (CDN).

UMA CDN:

  • Fornece várias vantagens de desempenho versus hospedar o ativo com o aplicativo Web.
  • Não recomendamos depender dela como a única fonte para o ativo. As CDNs nem sempre estão disponíveis, portanto, um fallback confiável deve ser usado. Normalmente, o fallback é o site que hospeda o aplicativo Web.

O Auxiliar de Marca de Script permite que você especifique uma CDN para o arquivo de script e um fallback quando a CDN não estiver disponível. O Auxiliar de Marca de Script fornece a vantagem de desempenho de uma CDN com a robustez da hospedagem local.

A marcação Razor a seguir mostra um elemento script com um 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>

Não use o <script> atributo de adiamento do elemento para adiar o carregamento do script CDN. O Auxiliar de Marca de Script renderiza o JavaScript que executa imediatamente a expressão asp-fallback-test . A expressão falhará se o carregamento do script CDN for adiado.

Atributos de Auxiliares de Marca de Script comumente usados

Consulte Auxiliar de Marca de Script para ver todos os atributos, propriedades e métodos do Auxiliar de Marca de Link.

src

Endereço do script externo a ser usado.

asp-append-version

Quando asp-append-version é especificado com um valor true junto com um atributo src, uma versão exclusiva é gerada.

Para que um Ajudante de Tags gere uma versão para um arquivo estático fora do wwwroot, confira Distribuir arquivos a partir de vários locais

asp-fallback-src

A URL de uma marca script para a qual fazer fallback caso a principal falhe.

asp-fallback-src-exclude

Uma lista separada por vírgulas de padrões de arquivo com globde scripts JavaScript a serem excluídos da lista de fallback, caso o primário falhe. Os padrões glob são avaliados em relação à configuração do aplicativo webroot. Deve ser usado em conjunto com asp-fallback-src-include.

asp-fallback-src-include

Uma lista separada por vírgulas de padrões de arquivo com glob de scripts JavaScript para o qual fazer fallback caso o primário falhe. Os padrões glob são avaliados em relação à configuração do aplicativo webroot.

asp-fallback-test

O método de script definido no script primário a ser usado para o teste de fallback. Para obter mais informações, consulte FallbackTestExpression.

asp-order

Quando um conjunto de instâncias ITagHelper é executado, seus métodos Init(TagHelperContext) são invocados primeiro na ordem especificada; em seguida, seus métodos ProcessAsync(TagHelperContext, TagHelperOutput) são invocados na ordem especificada. Valores maios baixos são executados primeiro.

asp-src-exclude

Uma lista separada por vírgulas de padrões de arquivo com glob de scripts JavaScript a serem excluídos do carregamento. Os padrões glob são avaliados em relação à configuração do aplicativo webroot. Deve ser usado em conjunto com asp-src-include.

asp-src-include

Uma lista separada por vírgulas de padrões de arquivo com glob de scripts JavaScript a serem carregados. Os padrões glob são avaliados em relação à configuração do aplicativo webroot.

asp-suppress-fallback-integrity

Valor booliano que determina se um hash de integridade será comparado com o valor asp-fallback-src.

Recursos adicionais