Bagikan melalui


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: