Pembantu Tag Skrip di ASP.NET Core
Oleh Rick Anderson
Pembantu Tag Skrip menghasilkan tautan ke file skrip utama atau mundur. Biasanya file skrip utama ada di Content Delivery Network (CDN).
A CDN:
- Memberikan beberapa keuntungan performa vs menghosting aset dengan aplikasi web.
- Tidak boleh diandalkan sebagai satu-satunya sumber untuk aset. CDN tidak selalu tersedia, oleh karena itu fallback yang andal harus digunakan. Biasanya fallback adalah situs yang menghosting aplikasi web.
Pembantu Tag Skrip memungkinkan Anda menentukan CDN untuk file skrip dan fallback saat CDN tidak tersedia. Pembantu Tag Skrip memberikan keuntungan performa CDN dengan ketahanan hosting lokal.
Markup berikut Razor menunjukkan script
elemen dengan 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>
Jangan gunakan atribut tunda <script>
elemen untuk menunda pemuatan skrip CDN. Pembantu Tag Skrip merender JavaScript yang segera menjalankan ekspresi asp-fallback-test . Ekspresi gagal jika memuat skrip CDN ditangguhkan.
Atribut Script Tag Helper yang umum digunakan
Lihat Script Tag Helper untuk semua atribut, properti, dan metode Script Tag Helper.
src
Alamat skrip eksternal yang akan digunakan.
asp-append-version
Ketika asp-append-version
ditentukan dengan true
nilai bersama dengan src
atribut, versi unik dihasilkan.
Agar Pembantu Tag menghasilkan versi untuk file statis di luar wwwroot
, lihat Menyajikan file dari beberapa lokasi
asp-fallback-src
URL tag Skrip yang akan di-fallback jika tag utama gagal.
asp-fallback-src-exclude
Daftar pola file skrip JavaScript yang dipisahkan koma untuk dikecualikan dari daftar fallback, jika yang utama gagal. Pola glob dinilai relatif terhadap pengaturan aplikasi webroot
. Harus digunakan bersama dengan asp-fallback-src-include
.
asp-fallback-src-include
Daftar pola file yang dipisahkan koma dari skrip JavaScript yang dipisahkan koma untuk mundur jika yang utama gagal. Pola glob dinilai relatif terhadap pengaturan aplikasi webroot
.
asp-fallback-test
Metode skrip yang ditentukan dalam skrip utama yang akan digunakan untuk pengujian fallback. Untuk informasi selengkapnya, lihat FallbackTestExpression .
urutan asp
Ketika sekumpulan ITagHelper
instans dijalankan, metodenya Init(TagHelperContext)
pertama kali dipanggil dalam urutan yang ditentukan; maka metodenya ProcessAsync(TagHelperContext, TagHelperOutput)
dipanggil dalam urutan yang ditentukan. Nilai yang lebih rendah dijalankan terlebih dahulu.
asp-src-exclude
Daftar pola file skrip JavaScript yang dipisahkan koma untuk dikecualikan dari pemuatan. Pola glob dinilai relatif terhadap pengaturan aplikasi webroot
. Harus digunakan bersama dengan asp-src-include
.
asp-src-include
Daftar pola file skrip JavaScript yang dipisahkan koma untuk dimuat. Pola glob dinilai relatif terhadap pengaturan aplikasi webroot
.
asp-suppress-fallback-integrity
Nilai Boolean yang menentukan apakah hash integritas akan dibandingkan dengan nilai asp-fallback-src.
Sumber Daya Tambahan:
ASP.NET Core