Aset Field Kode
Selain gaya dan skrip statis sebagai file, Blockstudio juga mendukung blok aset dinamis melalui field kode. Bergantung pada kebutuhan Anda, blok ini dapat dibatasi pada blok tertentu.
Penggunaan Dasar
Pada tingkat paling dasar, Anda dapat merender konten field kode secara manual di templat.
PHP
<div useBlockProps>
<h1>My block</h1>
</div>
<style><?php echo $attributes['css']; ?></style>
Twig
<div useBlockProps>
<h1>My block</h1>
</div>
<style>{{ attributes.css }}</style>
Pemilih Tercakup
Untuk menghindari konflik dengan blok lain, Anda dapat menggunakan variabel %selector% di dalam field kode bersama useBlockProps dalam templat rendering Anda.
Di field kode, %selector% menargetkan instans blok tertentu. Di file CSS dan SCSS, %selector% menargetkan kelas tercakup bersama milik blok tersebut.
Contoh
Misalkan kita ingin menargetkan tag h1 dari contoh di atas dalam field kode.
%selector% h1 {
color: red;
}
Sekarang, Blockstudio akan melakukan tiga hal:
- Membuat ID unik untuk instans blok tersebut
- Mengganti
%selector%dengan ID unik - Menambahkan pemilih yang sama ke elemen yang ditandai dengan
useBlockProps
Hasil akhirnya akan terlihat seperti ini:
<div data-assets="c9abe0d95c2b">
<h1>My block</h1>
</div>
<style>
[data-assets='c9abe0d95c2b'] h1 {
color: red;
}
</style>
Perenderan Otomatis
Merender tag style secara manual setiap kali bisa merepotkan. Agar proses ini lebih mudah, Anda dapat menggunakan atribut asset di dalam kolom kode.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "code",
"label": "Custom CSS",
"language": "css",
"asset": true
}
]
}
}
Ini akan otomatis membuat tag style untuk blok kode yang ditandai sebagai css dan memindahkannya ke head dokumen. Untuk kolom yang bahasanya ditandai dengan javascript, tag script akan dibuat dan ditempatkan di bagian bawah body.
Di Extensions
Saat menggunakan kolom kode di dalam extensions, atribut asset tidak diperlukan. Blockstudio akan otomatis merender konten kolom kode sebagai aset jika bahasanya adalah css atau javascript.
Contoh
{
"$schema": "https://blockstudio.dev/schema/extend",
"name": "core/*",
"blockstudio": {
"extend": true,
"attributes": [
{
"id": "customCss",
"type": "code",
"label": "Custom css",
"language": "css"
}
]
}
}
Tidak diperlukan konfigurasi tambahan. Cara di atas akan menampilkan kolom kode untuk setiap blok core/* di bilah sisi dan otomatis merender kontennya sebagai aset pada halaman.
SCSS
Kolom kode mendukung kompilasi SCSS. Atur bahasa ke scss dan Blockstudio akan mengompilasi nilainya melalui ScssPhp sebelum merendernya sebagai CSS.
{
"blockstudio": {
"attributes": [
{
"type": "code",
"id": "styles",
"label": "Styles",
"language": "scss",
"asset": true
}
]
}
}
Fitur SCSS seperti variabel, nesting, dan mixin semuanya berfungsi:
%selector% {
$primary: #3b82f6;
h1 {
color: $primary;
}
&:hover {
background: lighten($primary, 40%);
}
}
Di editor, SCSS dikompilasi di sisi server secara real time sehingga Anda dapat melihat hasilnya saat mengetik. Di frontend, kompilasi berlangsung saat blok dirender.