ASP.NET Core'da Betik Etiketi Yardımcısı

Makale
11/30/2023

Betik Etiketi Yardımcısı, birincil veya geri dönüş betik dosyasına bir bağlantı oluşturur. Birincil betik dosyası genellikle bir Content Delivery Network (CDN) üzerindedir.

A CDN:

Varlığı web uygulamasıyla barındırmaya kıyasla çeşitli performans avantajları sağlar.
Varlığın tek kaynağı olarak bağlı olmamalıdır. CDN'ler her zaman kullanılamaz, bu nedenle güvenilir bir geri dönüş kullanılmalıdır. Genellikle geri dönüş, web uygulamasını barındıran sitedir.

Betik Etiketi Yardımcısı, cdn kullanılabilir olmadığında betik dosyası için bir CDN ve bir geri dönüş belirtmenize olanak tanır. Betik Etiketi Yardımcısı, yerel barındırmanın sağlamlığıyla bir CDN'nin performans avantajını sağlar.

Aşağıdaki Razor işaretlemede geri dönüş içeren bir script öğe gösterilmektedir:

<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>

CDN betiğini yüklemeyi <script> ertelemek için öğenin defer özniteliğini kullanmayın. Betik Etiketi Yardımcısı, asp-fallback-test ifadesini hemen yürüten JavaScript'i işler. CDN betiği yüklenirken ertelenirse ifade başarısız olur.

Yaygın olarak kullanılan Betik Etiketi Yardımcısı öznitelikleri

Tüm Betik Etiketi Yardımcısı öznitelikleri, özellikleri ve yöntemleri için bkz. Betik Etiketi Yardımcısı.

src

Kullanılacak dış betiğin adresi.

asp-append-version

asp-append-version Bir öznitelikle birlikte bir true değerle src belirtildiğinde, benzersiz bir sürüm oluşturulur.

Etiket Yardımcısı'nın dışında wwwrootbir statik dosya için sürüm oluşturması için bkz. Birden çok konumdan dosya sunma

asp-fallback-src

Birincil etiketin başarısız olması durumunda geri dönmek için betik etiketinin URL'si.

asp-fallback-src-exclude

Birincil dosya başarısız olursa, geri dönüş listesinden dışlamak için JavaScript betiklerinin globbed dosya desenlerinin virgülle ayrılmış listesi. Glob desenleri uygulamanın webroot ayarına göre değerlendirilir. ile asp-fallback-src-includebirlikte kullanılmalıdır.

asp-fallback-src-include

Birincil komut dosyalarının başarısız olması durumunda geri dönmek için JavaScript betiklerinin genelleştirilmiş dosya desenlerinin virgülle ayrılmış listesi. Glob desenleri uygulamanın webroot ayarına göre değerlendirilir.

asp-fallback-test

Geri dönüş testi için kullanılacak birincil betikte tanımlanan betik yöntemi. Daha fazla bilgi için bkz. FallbackTestExpression.

asp-order

Bir örnek kümesi ITagHelper yürütülürken, yöntemleri Init(TagHelperContext) önce belirtilen sırayla çağrılır; ardından ProcessAsync(TagHelperContext, TagHelperOutput) yöntemleri belirtilen sırada çağrılır. Önce daha düşük değerler yürütülür.

asp-src-exclude

Yüklemenin dışında tutulacak JavaScript betiklerinin globed dosya desenlerinin virgülle ayrılmış listesi. Glob desenleri uygulamanın webroot ayarına göre değerlendirilir. ile asp-src-includebirlikte kullanılmalıdır.

asp-src-include

Yüklenecek JavaScript betiklerinin globbed dosya desenlerinin virgülle ayrılmış listesi. Glob desenleri uygulamanın webroot ayarına göre değerlendirilir.

asp-suppress-fallback-integrity

Bütünlük karması ile asp-fallback-src değerinin karşılaştırılıp karşılaştırılmadığını belirleyen Boole değeri.

Aracılığıyla paylaş