Lewati ke konten

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.

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.

PHP
$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 ...>',
];
  • type adalah style untuk CSS dan module untuk JavaScript. Aset JavaScript berbasis file milik Blockstudio menggunakan modul ES, termasuk skrip inline.
  • handle adalah pengenal aset stabil yang digunakan oleh perender Blockstudio dan filter blockstudio/assets/disable. Aset ini tidak harus dimasukkan ke antrean di WordPress.
  • url adalah URL aset terkompilasi yang ada setelah diselesaikan, termasuk versinya, atau URL sumber jika tidak ada file terkompilasi. Nilainya null untuk aset inline.
  • inline membedakan keluaran inline <style>/<script> dari file eksternal.
  • scope mencantumkan konteks tempat aset berlaku: frontend dan editor untuk file bersama, dan hanya satu untuk file view/editor.
  • html berisi 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.