Auxiliar de Marca de Âncora no ASP.NET Core
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.