Aset
Blockstudio menyediakan pipeline aset tanpa konfigurasi untuk blok Anda. Letakkan file CSS, SCSS, atau JavaScript di samping blok Anda, lalu file tersebut akan dikompilasi, diminifikasi, dan diantrekan secara otomatis.
- Mendaftarkan Aset: Konvensi penamaan file dan perilaku antrean
- Pemrosesan: Kompilasi SCSS, impor modul ES, dan minifikasi
- Kolom Kode: Pengeditan kode sebaris melalui jenis kolom kode
Memeriksa Aset Blok
bs_block_assets('theme/card') mengembalikan aset frontend dan kanvas editor yang ditemukan dari blok Blockstudio terdaftar. Panggil setelah pendaftaran blok, pada init atau setelahnya. Blok yang tidak dikenal, blok non-Blockstudio, dan blok tanpa aset mengembalikan []. Helper ini tidak merender blok, memasukkan apa pun ke antrean, atau memicu kompilasi.
$assets = bs_block_assets('theme/card');
// Each entry has this shape:
[
'type' => 'style',
'handle' => 'blockstudio-theme-card-style-css',
'url' => '/wp-content/blockstudio/cache/.../style-123.css?ver=123',
'inline' => false,
'scope' => ['frontend', 'editor'],
'html' => '<link ...>',
];
typeadalahstyleuntuk CSS danmoduleuntuk JavaScript. Aset JavaScript berbasis file milik Blockstudio menggunakan modul ES, termasuk skrip inline.handleadalah pengenal aset stabil yang digunakan oleh perender Blockstudio dan filterblockstudio/assets/disable. Aset ini tidak harus dimasukkan ke antrean di WordPress.urladalah URL aset terkompilasi yang ada setelah diselesaikan, termasuk versinya, atau URL sumber jika tidak ada file terkompilasi. Nilainyanulluntuk aset inline.inlinemembedakan keluaran inline<style>/<script>dari file eksternal.scopemencantumkan konteks tempat aset berlaku:frontenddaneditoruntuk file bersama, dan hanya satu untuk file view/editor.htmlberisi tag siap pakai dari perender aset biasa. Konten inline, CSS yang dicakup, lapisan gaya UI, dan filter penonaktifan saat render ditangani dengan cara yang sama seperti keluaran blok biasa.
File SCSS yang hilang, kosong, dinonaktifkan, dan belum dikompilasi tidak disertakan. Aset dokumen induk admin dan editor blok yang dimasukkan ke antrean oleh WordPress dikecualikan. Daftar ini terbatas pada file milik blok yang ditemukan. Daftar ini bukan penutupan dependensi: blok bersarang, nilai bidang kode, handle yang dimasukkan ke antrean oleh WordPress, impor modul CSS, Tailwind, serta runtime UI/Interactivity bersama mungkin bergantung pada konten yang dirender. Gunakan Render::document() untuk pratinjau mandiri yang lengkap. Gunakan bs_block_fields() untuk memeriksa definisi bidang yang terdaftar.