Memproses Aset
Minifikasi
Blockstudio dapat otomatis meminifikasi semua file CSS dan JS dalam sebuah blok.
File yang dikompilasi akan disimpan ke folder _dist pada blok dan diantrekan saat blok digunakan. Ketika file sumber diperbarui, Blockstudio memeriksa apakah ada file hasil kompilasi dengan stempel waktu tersebut; jika tidak, file akan dibuat.
Pustaka minify digunakan untuk tujuan ini.
Minifikasi dapat diaktifkan menggunakan pengaturan assets/minify:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Jika Anda lebih suka menulis style dalam SCSS, Anda dapat mengaktifkan pemrosesan SCSS:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Ini akan mengaktifkan pemrosesan SCSS untuk file .css.
Sebagai alternatif, Anda dapat menggunakan ekstensi .scss dan style akan otomatis diproses meskipun pengaturan di atas tidak true.
Jalur Impor
Saat menggunakan SCSS, Anda dapat mengimpor file SCSS lainnya. Impor bersifat relatif terhadap file tempat file tersebut diimpor.
@import "modules.scss";
Selain itu, jalur impor khusus dapat ditentukan menggunakan filter blockstudio/assets/process/scss/import_paths, sehingga file dapat diimpor dari direktori lain tanpa menyebutkan struktur folder.
Impor dapat menghilangkan ekstensi .scss dan merujuk partial seperti _tokens.scss atau _index.scss milik sebuah direktori.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Prelude
Jika Anda ingin fungsi, variabel, mixin, atau utilitas Sass yang digunakan bersama tersedia di setiap file SCSS, Anda dapat menambahkan prelude global sebelum kompilasi.
Ini berguna untuk framework seperti Bootstrap, saat Anda mungkin ingin mengakses mixin bersama seperti breakpoint tanpa mengulangi impor di setiap aset blok.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
Jika digabungkan dengan blockstudio/assets/process/scss/import_paths, ini membuat permukaan Sass yang dirujuk tersedia untuk setiap file yang dikompilasi.
Aset blok dikompilasi ulang saat waktu modifikasi dependensi berubah, termasuk file yang diimpor oleh partial lain. Blockstudio melacak dependensi lokal @import, @use, dan @forward, termasuk dependensi prelude dan jalur impor yang dikonfigurasi. Dependensi bersama dilacak satu kali, dan siklus tidak dapat menyebabkan proses penelusuran berulang tanpa henti. File-file ini juga disertakan dalam daftar pantauan cache runtime.
Misalnya, mengedit mixins/_wysiwyg.scss akan mengompilasi ulang global-styles.scss jika file itu mengimpor scss/_wysiwyg.scss, yang kemudian mengimpor mixin tersebut. Perubahan tidak mengharuskan Anda menyentuh file entri. Modul bawaan Sass dan impor jarak jauh tidak disertakan dalam grafik dependensi lokal.
Modul ES
Semua skrip (sebaris dan default) di Blockstudio dimuat dengan type="module" yang diterapkan secara default. Artinya, Anda dapat menggunakan sintaks impor untuk skrip blok Anda tanpa penyiapan tambahan.
Catatan
Untuk pembahasan modul ES yang lebih mendalam, kunjungi dokumentasi web MDN.
Bayangkan kode berikut di dalam script.js:
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";
const html = htm.bind(h);
function App(props) {
confetti();
return html`<h1>Hello ${props.name}!</h1>`;
}
render(
html`<${App} name="Hello from Preact!" />`,
document.querySelector("#element")
);
Contoh di atas akan membuat komponen menggunakan Preact, dengan mengimpor semua komponen dan fungsi yang diperlukan dari CDN yang kompatibel dengan ESM, dalam hal ini esm.sh. Pendekatan ini tidak salah, tetapi mengharuskan aset yang diperlukan diminta dari situs eksternal, sehingga skrip dapat rusak jika CDN mengalami gangguan.
Blockstudio menyediakan cara praktis untuk mengunduh Modul ES ke blok, sehingga tidak perlu menggunakan CDN ESM eksternal saat produksi.
Penyiapan
Untuk mengunduh modul ke direktori blok, gunakan awalan npm: diikuti nama dan versi paket:
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
Sintaks ini mengikuti konvensi Denonpm.
Catatan
Awalan lama
blockstudio/(e.g.,blockstudio/preact@10.15.1) masih didukung untuk kompatibilitas ke belakang, tetapi kami menyarankan penggunaan awalannpm:untuk proyek baru. Lihat panduan migrasi untuk detailnya.
Blockstudio akan otomatis memeriksa file .js yang berubah untuk menemukan impor dan mengunduhnya ke direktori blok lokal. File yang diunduh akan ditempatkan di folder modules dalam direktori blok.
File skrip akan ditulis ulang saat disimpan agar menggunakan modul yang di-host secara lokal:
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";
Saat berada di editor, URL CDN tetap akan digunakan (Blockstudio menggunakan esm.sh) saat Anda melihat pratinjau dan mengerjakan blok.
Hal yang Perlu Diperhatikan
Versi
Biasanya, modul dapat digunakan dari CDN tanpa nomor versi. Dalam kasus ini, versi terbaru akan selalu digunakan. Karena Blockstudio tidak menyimpan informasi apa pun ke dalam database, nomor versi wajib digunakan saat memakai modul.
Modul yang Sama
Modul memiliki cakupan per blok. Meskipun Anda menggunakan modul yang sama dengan nomor versi yang sama di beberapa blok, Blockstudio tetap akan mengunduh modul yang diminta ke blok tersebut. Hal ini terutama karena blok seharusnya menjadi unit mandiri yang mudah dibagikan ke instalasi atau situs lain.
Selain itu, modul yang sama akan diminta dua kali jika kedua blok ada di halaman. Masalah ini dapat diatasi dengan menggunakan script-inline.js, bukan file script.js. Blockstudio akan menulis ulang setiap impor agar mengarah ke lokasi kemunculan pertama modul jika nama dan nomor versinya sama.
Loader CSS
File CSS juga dapat diimpor menggunakan sintaks yang sama seperti di atas.
import "npm:swiper@11.0.0/swiper.min.css";
File CSS akan diunduh ke folder modules dan otomatis diantrekan saat blok digunakan. Selama versinya sama, hanya satu versi file CSS yang akan diantrekan, meskipun file tersebut ada di beberapa blok.